Volume 7A: XView Programming Manual

frame, about, 26-28

base frame, 26, 61-62

closed base frame, 66

command frame, 61, 68

display, setting, 69

headers and footers, 63

in class hierarchy, 18

initialization, 62

modifying open/close using the Notifier, 491

multiple screens, 351

pop-up, 26

providing visual feedback, 74

role of window manager, 61

size, setting, 74

subframe, 61

FRAME package, 59-82, 69

FRAME_ACCELERATOR

attribute, 147

FRAME_BUSY attribute, 74

FRAME_CLOSED attribute, 342

FRAME_CLOSED_RECT attribute, 66

FRAME_CMD package, 68-69

FRAME_CMD_DEFAULT_PIN_STATE

attri-

bute, 69

FRAME_CMD_PANEL

attribute, 293

FRAME_CMD_PIN_STATE attribute, 69

FRAME_DONE_PROC

attribute, 71

frame_fit_all macro, 77

FRAME_FOCUS_DIRECTION

attribute, 147

FRAME_FOCUS_RIGHT, 147

FRAME_FOCUS_UP

, 147

FRAME_FOCUS_WIN attribute, 146

frame_get_rect procedure, 74

FRAME_ICON attribute, 66

frame_kbd_use procedure, 146

FRAME_LABEL attribute, 64

FRAME_MAX_SIZE attribute, 73

FRAME_MENU_ADD

attribute, 695

FRAME_MENU_COUNT attribute, 695

FRAME_MENU_DELETE

attribute, 695

FRAME_MENUS

, 695

FRAME_MENUS attribute, 695

FRAME_MIN_SIZE attribute, 73

FRAME_NO_CONFIRM attribute, 67

FRAME_NTH_SUBFRAME attribute, 76

FRAME_NTH_SUBWINDOW attribute, 76

frame_set_rect procedure, 74

FRAME_SHOW_FOOTER

attribute, 65

FRAME_SHOW_HEADER attribute, 64

FRAME_SHOW_RESIZE_CORNER attribute,

73

FRAME_WM_COMMAND_ARGC

attribute, 78

FRAME_WM_COMMAND_ARGC_ARGV attri-

bute, 78, 495

FRAME_WM_COMMAND_ARGV attribute, 78

FRAME_WM_COMMAND_STRINGS attribute,

78

FRAME_X_ACCELERATOR attribute, 147

freeing the server, 359

FULLSCREEN package, 359

G

gap between panel items, 159

gauge item, 188

GC, about, 96-98

font ID, 367

fonts, 370

repainting objects, example of, 98

generic, attributes, 22

functions, table of, 21

generic object, 19, 24-25

getitimer system call, 462

gettext() procedure, 544

getting an object’s package, 572

global variable, xv_default_server, 353

global variables, 199

glyphs, 178, 330, 367

grabbing the server, 359

graphics, 355

CANVAS_X_PAINT_WINDOW

, 94

cursor images, 327

draw programs, 89

exposure events, 92, 122

paint programs, 90

rendering in color, 521

rendering methods, 91

rendering text, example of, 370

SunView, 91

text-based programs, 90

visualization programs, 90

Xlib drawing, example of, 333

XView model, 91

(see also server image)

GraphicsExpose event, 92

H

handle, for object, 19

header,

FRAME_SHOW_HEADER attribute, 64

of a frame, 63

header file, about, 42

canvas.h, 88

756 XView Programming Manual

header file (cont’d)

cms.h, 333

cursors.h, 327

defaults.h, 385

dragdrop.h, 435

fonts.h, 368

icon.h, 339

notice.h, 308, 655

notify.h, 463

openmenu.h, 277

panel.h, 155

rect.h, 66

screen.h, 350

sel_pkg.h, 397, 399

server.h, 353

signal.h, 465

svrimage.h, 356

textsw.h, 216

tty.h, 241

win_event.h, 119, 125

win_input.h, 119, 124-125

X.h, 119

Xlib.h, 96, 350

xv_error.h, 570

xview.h, 42

help, example, 559

installation, 562

help facilities, 557-564

help frame, 27

HELPPATH

environment variable, 558, 562

HELP_STRING_FILENAME attribute, 561

hidden class, 85

hints, to window manager, 61

HISTORY_LIST

, 687

HISTORY_MENU, 687

I

ICCCM

, (See Inter-Client Communications Con-

ventions Manual).

icon, 66

about, 34, 339

creating, 339

positioning image, 342

server image, 340

size, 344

text label, 344

ICON

package, 339-345

icon.h header file, 339

iconification, 66, 340

ICON_IMAGE attribute, 342

ICON_IMAGE_RECT

attribute, 342

ICON_LABEL attribute, 344

ICON_LABEL_RECT attribute, 344

ICON_MASK_IMAGE attribute, 344

ICON_TRANSPARENT attribute, 343

ICON_TRANSPARENT_LABEL attribute, 345

include files, (See header file).

inheritance, 19, 85, 88

initialization, 45, 62

(see also xv_init procedure)

input, about, 9

handling, event-driven, 460;

mainline, 459

handling of, 115-148

in CANVAS package, 105

input masks, 116

inputLang resources, 541

Inputmask structure, 119, 131-132

interclient communication, 9, 393-430,

635-652

interclient communications, 433-456

Inter-Client Communications Conventions

Manual, 9

internationalization, 537-553

about, 537

attributes for gettext(), 549

bindtextdomain(), 546

creating text domain, 547

dgettext() procedure, 545

gettext() procedure, 544

handling text, 543

locale command-line options, 541

locale resources, 541

locale setting, 538

locale specification, 541

objects, 550

OPEN LOOK

user interface, 539

POSIX

categories, 542

textdomain(), 545

xview locale attributes, 540

interposition, 37, 488-498

scrolling, 264

intrinsics, definition of, 580

xview, 580

ioctl system call, 462

item, gauge, 188

ITIMER_REAL enum, 467

ITIMER_VIRTUAL

enum, 467

Index 757

K

KBD_DONE event, 121, 129

KBD_USE event, 121, 129

keyboard, event states, 126

keyboard events, 121

keyboard focus, about, 5

defined by window manager, 9

directing under program control, 129

events, 121

grabbing, 129, 359

keyboard focus item, notification, 192

setting a value, 193

KEY_BOTTOM macro, 128

KEY_LEFT macro, 128

KEY_RIGHT macro, 128

KeySym, 117

KEY_TOP macro, 128

L

-lc_basiclocale command-line option, 541

-lc_displaylang command-line option, 541

-lc_inputlang command-line option, 541

-lc_numeric command-line option, 541

-lc_timeformat command-line option, 541

libraries, for XView, 42

line, editing in text subwindow, 226

list item, adding and deleting, 181

displaying, 178

notification, 183

selection, 182

lists, attribute-value, 582

LOC_DRAG

event, 120

LOC_MOVE

event, 106, 120

LOC_WINENTER

event, 106, 120, 129

LOC_WINEXIT event, 106, 120

M

macro, ATTR_CONSUME, 587, 598

attr_next, 584

ATTR_PKG_UNUSED_FIRST

, 594

ATTR_PKG_UNUSED_LAST, 594

ATTR_STANDARD_SIZE, 583

BUT, 129

CANVAS_EACH_PAINT_WINDOW

, 104

CANVAS_END_EACH, 104

CMS_CONTROL_COLORS, 524

DefaultColormap, 515

dnd_is_local(), 443

event_action, 126

event_button_is_down, 128

event_id, 126

event_is_ascii, 127

event_is_button, 128

event_is_down, 126

event_is_iso, 127

event_is_key_bottom, 128

event_is_key_left, 128

event_is_key_right, 128

event_is_key_top, 128

event_is_up, 126

event_left_is_down, 128

event_middle_is_down, 128

event_right_is_down, 128

event_string, 127

event_window, 125

event_xevent, 92

frame_fit_all, 77

KEY_BOTTOM, 128

KEY_LEFT, 128

KEY_RIGHT

, 128

KEY_TOP, 128

OPENWIN_EACH_VIEW

, 105

PANEL_CHECK_BOX, 174

PANEL_CHOICE_STACK

, 173

PANEL_EACH_ITEM, 165

PANEL_END_EACH

, 165

panel_set_value, 193

PANEL_TOGGLE

, 172

window_fit, 77, 164

window_fit_height, 77, 164

window_fit_width, 77, 164

XDefaultColormap, 515

xv_alloc, 596

XV_ATTR

, 583

XV_DEFAULT_CMS_SIZE

, 516

XV_INIT_ARGS, 46

XV_PRIVATE

, 593

XV_PUBLIC

, 593

XV_SERVER_FROM_WINDOW, 138

mainline input handling, 459

MapNotify event, 54

menu, about, 31, 273

adding menu items, 285

appending new item, 283

creating, 277

default item, 297

destroying, 298

displaying image, 284, 286

finding items, 297

freeing allocated strings, 299

freeing pullright menus, 299

758 XView Programming Manual

menu (cont’d)

generation procedures, 287

menu title, 282

notification procedures, 294

owner of, 277

pin-up, 292

position of menu item, 282

pullright, 285

pullright menus, 274

selected item, 297

setting inactive items, 294

string handling, 282

toggle (nonexclusive) settings, 291

XView implementation, 274

Menu accelerators, 695

menu buttons, on panels, 167

MENU

package, 273-304, 277

MENU_ACCELERATOR attribute, 696

MENU_ACCELERATORS attribute, 696

MENU_ACTION_ACCELERATOR attribute,

696

MENU_ACTION_IMAGE

attribute, 284

MENU_ACTION_ITEM attribute, 283-284

MENU_APPEND_ITEM

attribute, 284

MENU_CHOICE_MENU package, 278

MENU_CLIENT_DATA

attribute, 199, 300

MENU_COMMAND_MENU package, 277

MENU_DEFAULT_ITEM

attribute, 297

MENU_DESCEND_FIRST attribute, 297

MENU_DONE_PROC

attribute, 279, 293

MENU_FIRST_EVENT attribute, 279

MENU_GEN_PIN_WINDOW

attribute, 292

MENU_GEN_PROC attribute, 287

menu_gen_proc procedure, 288

MENU_GEN_PULLRIGHT attribute, 287

MENU_GEN_PULLRIGHT_ITEM attribute, 288

MENU_IMAGE

attribute, 284

MENU_IMAGES attribute, 286

MENU_INACTIVE

attribute, 294

MENU_ITEM

attribute, 283, 299

MENUITEM package, 283-284

MENU_LAST_EVENT attribute, 279

MENU_NCOLS attribute, 292

MENU_NITEMS attribute, 288

MENU_NOTIFY_PROC attribute, 282, 294

menu_notify_proc procedure, 282, 294

MENU_NOTIFY_STATUS

attribute, 298

MENU_NROWS attribute, 292

MENU_NTH_ITEM attribute, 288

MENU_PARENT attribute, 290

MENU_PIN

attribute, 293

MENU_PIN_PROC attribute, 293

MENU_PIN_WINDOW attribute, 293

MENU_PULLRIGHT attribute, 285

MENU_PULLRIGHT_IMAGE attribute, 285

MENU_PULLRIGHT_ITEM attribute, 285

MENU_RELEASE attribute, 285, 298

MENU_RELEASE_IMAGE attribute, 287

MENU_REMOVE attribute, 288

MENU_SELECTED_ITEM attribute, 297

menu_show procedure, 278-279

MENU_STRING attribute, 283-284

MENU_STRINGS attribute, 282

MENU_STRINGS_AND_ACCELERATORS attri-

bute, 696

MENU_TITLE_ITEM attribute, 282

MENU_TOGGLE_MENU package, 278, 291

message item, 184

selection, 184

messages, client, 123

modifier keys, 126

modifying the display list, 686

monitoring scrolling events, 264

motion events, 120

mouse, button events, 121;

registering interest in, 119

button, re-mapping, 117

event states, 126

getting coordinate position, 330

motion events, 120

position, 124

mouseless model, 142

keyboard command mapping, 143

location cursor, 146

MS_LEFT

event, 126

multiline text item, 188, 193

N

nonexclusive choice, 172

nonvisual objects, 349-363

about, 34

notice, about, 27, 307, 655

busy frames, 316

creating, 308, 655

destroying, 320

displaying, 308, 655

implementation, 655

origin, 657

responses, 311, 658

screen-locking, 316

standard, 313

status, 311

suppressing beep, 320, 661

triggers, 318, 659

Index 759

notice (cont’d)

types, 313

NOTICE package, 307-324

use of FULLSCREEN package, 359

NOTICE_BLOCK_THREAD attribute, 313

NOTICE_BUSY_FRAMES attribute, 313, 316

NOTICE_BUTTON attribute, 658

NOTICE_BUTTON_NO attribute, 311

NOTICE_BUTTON_YES attribute, 311, 658

NOTICE_EVENT_PROC attribute, 315

NOTICE_FOCUS_XY attribute, 317, 657

notice.h header file, 308, 655

NOTICE_LOCK_SCREEN attribute, 313

NOTICE_MESSAGE_STRING attribute, 309

NOTICE_MESSAGE_STRINGS attribute, 309,

312, 658

NOTICE_MESSAGE_STRINGS_ARRAY_PTR

attribute, 309, 574

NOTICE_NO attribute, 497

NOTICE_NO_BEEPING attribute, 661

notice_prompt procedure, 655

NOTICE_STATUS

attribute, 311

NOTICE_TRIGGER attribute, 318

NOTICE_TRIGGER_EVENT

attribute, 320

NOTICE_YES attribute, 497

notification, menus, 294

notification procedures, in a text subwindow,

233

Notifier, 459-510

about, 10, 459

base event handler, 488

client, 463

client events, 474

control, 498

definition, 461

destroy event delivery time, 479

error codes, 507-508

explicit dispatching, 498, 501

file descriptors, 479

flow of control in Notifier-based programs, 36

handling X events, 54

implicit dispatching, 498

interposing on frame open/close, 491

interposing on resize events, 493

interposition, 37, 488

miscellaneous issues, 509

operation, 461

overview, 35

pipes, 482

posting events, 475;

client, 476;

destroy, 478;

with an argument, 477

procedures of, 460

prohibited signals, 464

reading, 480

role of xv_main_loop procedure, 54

safe destruction, 479

signal handling, 464

SIGTERM handling, 470

timers, 467

Notifier procedures

notify_default_wait, 3, 472

notify_do_dispatch, 499

notify_interpose_destroy_func, 494

notify_interpose_event_func, 491

notify_next_event_func, 492

notify_post_destroy, 478

notify_post_event, 475

notify_post_event_and_arg, 477-478

notify_set_destroy_func, 464

notify_set_exception_func, 465

notify_set_input_func, 465, 480

notify_set_itimer_func, 462, 467

notify_set_output_func, 465, 480

notify_set_signal_func, 465-466

notify_set_wait3_func, 464, 471

notify_veto_destroy, 494

notify procedure, 35

Notify_arg, 475, 478

NOTIFY_ASYNC

enum, 465

NOTIFY_BADF, 508

NOTIFY_BAD_ITIMER

, 508

NOTIFY_BAD_SIGNAL, 508

Notify_client, 475

Notify_copy, 478

NOTIFY_COPY_NULL, 478

notify_default_wait3 procedure, 472

NOTIFY_DESTROY_VETOED

, 479, 508

notify_dispatch procedure, 498

notify_do_dispatch procedure, 499

NOTIFY_DONE

, 472, 475

notify_enable_rpc_svc(), function, 473

notify_errno, 507

Notify_error, 507

Notify_event, 475-476

Notify_event_type, 475

NOTIFY_FUNC_LIMIT, 508

notify.h header file, 463

NOTIFY_IGNORED

, 472, 475-476, 490

NOTIFY_IMMEDIATE, 475-476

NOTIFY_INTERNAL_ERROR, 508

notify_interpose_destroy_func procedure,

463, 494

notify_interpose_event_func function, 206

760 XView Programming Manual