Volume 7A: XView Programming Manual

Index

A

abbreviated choice item, 171, 173

abbreviated view, 687

abort function, 568, 572

accelerator keys, used in notices, 658

ACTION_MENU event, 279

ACTION_SELECT event, 126, 175

alarm system call, 462

applications, structure of, 41

Attr_attribute type, 582-583

Attr_avlist type, 583

ATTR_CONSUME macro, 587, 598

attr_create_avlist function, 583

attr_find function, 586

attribute, attribute-value pair, 22-23

changing, 22

consuming, 587

customizable, 587

FRAME_MAX_SIZE

, 73

FRAME_MIN_SIZE

, 73

FRAME_SHOW_RESIZE_CORNER

, 73

generic and common, described, 22

HELP_STRING_FILENAME

, 561

naming conventions, 22

PANEL_VALUE_STORED_LENGTH

, 184

SCROLLBAR_COMPUTE_SCROLL_PROC

, 263

SCROLLBAR_NORMALIZE_PROC

, 263

TTY_ARGV, 247

WIN_MESSAGE_DATA, 131

WIN_MESSAGE_FORMAT, 131

WIN_MESSAGE_TYPE, 131

attribute-value lists, 582

ATTR_LIST attribute, 583

attr_next macro, 584

ATTR_PKG_UNUSED_FIRST macro, 594

ATTR_PKG_UNUSED_LAST

macro, 594

ATTR_STANDARD_SIZE macro, 583

auto-expand, 98

auto-shrink, 98

B

base frame, closed, 66

creating, 62

defined, 61

basicLocale resources, 541

BitGravity, set for canvases, 88

windows, 94

blocking, 479

busy frames, 74

BUT macro, 129

button item, 166

label, 166

selection, 167

C

callback procedure, 35, 116

callback style of programming, 35

canvas, about, 30, 85-86

automatic sizing, 98

callback procedures, 106

controlling size of, 98

creating, 88

default input mask, 106

drawing in, 89

getting view windows, 104

handling input, 105

height of subwindow, 99

model of, 86

paint window, 86-87

repaint procedure, 91-98

repainting, 89, 94

resize procedure, 100

scrolling, 101

splitting views, 102

subclassed from openwin, 85

subwindow, 85-86

tracking changes in size, 100

tracking events, 122

Index 751

canvas (cont’d)

view window, 85-86

width of subwindow, 99

CANVAS package, 85-111

CANVAS_AUTO_CLEAR attribute, 93

CANVAS_AUTO_EXPAND attribute, 98

CANVAS_AUTO_SHRINK attribute, 98-99

CANVAS_CMS_REPAINT attribute, 94, 528

CANVAS_EACH_PAINT_WINDOW macro, 104

CANVAS_END_EACH macro, 104

CANVAS_FIXED_IMAGE attribute, 88, 94

canvas.h header file, 88

CANVAS_HEIGHT attribute, 99

CANVAS_MIN_PAINT_HEIGHT attribute, 99

CANVAS_MIN_PAINT_WIDTH attribute, 99

CANVAS_NTH_PAINT_WINDOW attribute, 104

CANVAS_PAINTWINDOW_ATTRS

attribute,

461

CANVAS_REPAINT_PROC attribute, 91

CANVAS_RESIZE_PROC attribute, 100, 122

CANVAS_RETAINED attribute, 88

CANVAS_VIEWABLE_RECT

attribute, 93

CANVAS_VIEW_PAINT_WINDOW attribute,

104-105

CANVAS_WIDTH attribute, 99

CANVAS_X_PAINT_WINDOW

attribute, 94

cascading menu, (See pullright menu).

chained inheritance, 19

checkbox item, 171, 174

choice item, 171

abbreviated, 171, 173

checkbox, 171

checkboxes, 174

display, 171

exclusive and nonexclusive, 171-172

foreground color, 175

getting image, 173

layout, 171

notification, 175

parallel lists, 176

selection, 175

class, definition of, 580

generic, 580

subclass, 580

class hierarchy, 18

client, about, 5

events, 474, 509

messages, 116, 123, 130;

interpreting, 130;

sending and reading, 130

client data attribute, 199

clipboard, 220, 637

closing frames, (See iconification).

CMS package, 513-534, 516

CMS_BACKGROUND_PIXEL attribute, 521

CMS_COLOR_COUNT attribute, 516

CMS_COLOR_INDEX attribute, 523

CMS_COLORS attribute, 517

CMS_CONTROL_CMS attribute, 524

CMS_CONTROL_COLORS macro, 524

CMS_FOREGROUND_PIXEL attribute, 521

cms.h header file, 333

CMS_INDEX attribute, 516

CMS_INDEX_TABLE attribute, 519

CMS_NAME attribute, 519, 527

CMS_NAMED_COLORS attribute, 517

CMS_PIXEL attribute, 520

CMS_SIZE

attribute, 516

CMS_TYPE

attribute, 515

CMS_X_COLORS

attribute, 518

collapsing expose events, 92

color, 513-534

background, 520

colormap segment, 513;

default, 515;

definition of, 519;

dynamic, 515;

static, 515

colormap table, definition of, 519

cursor, setting for, 333

definition of RGB, 519

foreground, 520

panel items, example of, 525

resources, 524

Xv_Screen, 516

color RGB, 517

color Xv_Screen, 516

colormap segment, types, 515

colormap segments, xv_find, 527

command frame, 27, 68

defined, 61

command-line option, -lc_basiclocale, 541

-lc_displaylang, 541

-lc_inputlang, 541

-lc_numeric, 541

-lc_timeformat, 541

common attributes, 22

compiling XView programs, 41

confirmation of quit,

FRAME_NO_CONFIRM

attribute, 67

connection, between server and client, 6

control area, implemented as panel, 153

create_cursor procedure, 333

752 XView Programming Manual

curses(3X), 241, 247

cursor, about, 327

as font character, 330

color, 329

color, setting, 333

hotspot, 330

predefined, 330

Xv_Cursor, 327

CURSOR package, 327-335

CURSOR_BACKGROUND_COLOR, 333

CURSOR_DRAG_STATE attribute, 334

CURSOR_DRAG_TYPE attribute, 334

CURSOR_FOREGROUND_COLOR, 333

CURSOR_IMAGE attribute, 327

CURSOR_MASK_CHAR attribute, 330

cursors.h header file, 327

CURSOR_SRC_CHAR

attribute, 330

CURSOR_STRING attribute, 334

CURSOR_XHOT attribute, 330

CURSOR_YHOT attribute, 330

customizable attributes, 587

D

DefaultColormap macro, 515

defaults, 381

package, 381-390

(see also resources)

defaults_get_boolean procedure, 385

defaults_get_character procedure, 387

defaults_get_enum procedure, 388

defaults_get_integer procedure, 387

defaults_get_string procedure, 387

defaults.h header file, 385

defaults_init procedure, 385

defaults_load_db procedure, 385

defaults_set_boolean procedure, 385

defaults_set_character procedure, 387

defaults_set_integer procedure, 387

defaults_set_string procedure, 387

defaults_store_db procedure, 385

delayed binding, 277, 339

DESTROY_CHECKING, 479, 494

DESTROY_CLEANUP, 494

destroying frames, 79

DESTROY_PROCESS_DEATH

, 478, 494

DESTROY_SAVE_YOURSELF, 495

Destroy_status, 494

destruction of objects, 494

safe, 479

dgettext() procedure, 545

dispatching, explicit, 501

dispatching by Notifier, explicit, 498

implicit, 498

display, distinguished from screen, 6

Display structure, 350

displaying frames, 69

displayLang resources, 541

distributed processing, about, 7

DND_ACCEPT_CURSOR attribute, 441

DND_ACCEPT_X_CURSOR attribute, 441

DND_CURSOR attribute, 441

dnd_decode_drop() procedure, 442

dnd_done() procedure, 443

dnd_is_local() macro, 443

dnd_send_drop() procedure, 439

DND_TIMEOUT_VALUE

attribute, 442

DND_TYPE

attribute, 439

DND_X_CURSOR

attribute, 441

dot files, 687

drag and drop, about, 433

accept cursor, 441

adding and deleting regions, 436

event handling, 437

receiving a drop, 442

registering drop-sites, 436

sending the drop, 439

sourcing the drag, 439

use with selection package, 441

DRAGDROP

package, 433-456

dragdrop.h header file, 435

draw programs, 89

drawing in a canvas, 89

drop target item, 194

DROP_SITE_DEFAULT

attribute, 436

DROP_SITE_DELETE_REGION attribute, 437

DROP_SITE_DELETE_REGION_PTR

attribute,

437

DROP_SITE_EVENT_MASK attribute, 436, 438

DROP_SITE_ID

attribute, 436, 438

DROP_SITE_ITEM package, 433-456

DROP_SITE_REGION

attribute, 436

DROP_SITE_REGION_PTR attribute, 436

dup2 system call, 482

E

edit log, 222

editing, (see text subwindow)

enum,

ITIMER_REAL, 467

ITIMER_VIRTUAL, 467

NOTIFY_ASYNC, 465

NOTIFY_SYNC

, 465

Index 753

enum (cont’d)

enumerated resources, 388

enumerated type, ERROR_NON_RECOVER-

ABLE, 571

ERROR_RECOVERABLE, 571

environment variable, HELPPATH, 558, 562

error handling, advanced usage, 570

Xlib errors, 569

error recovery, 567-574

ERROR_BAD_ATTR attribute, 570

ERROR_BAD_VALUE attribute, 570

ERROR_CANNOT_GET attribute, 570

ERROR_CANNOT_SET attribute, 570

ERROR_CREATE_ONLY attribute, 570

ERROR_INVALID_OBJECT attribute, 571

ERROR_LAYER attribute, 571

ERROR_NON_RECOVERABLE

enumerated

type, 571

ERROR_PKG attribute, 571

error_proc procedure, 568

ERROR_RECOVERABLE enumerated type,

571

errors, advanced usage, 570

at run time, 567

recovery, 567

types, 570

Xlib, 569

ERROR_SERVER_ERROR

attribute, 571

ERROR_SEVERITY attribute, 571

ERROR_STRING

attribute, 571

escape sequences, sending to TTY subwindows,

243

event,

ACTION_MENU, 279

ACTION_SELECT

, 126, 175

Expose, 92

GraphicsExpose, 92

KBD_DONE

, 121, 129

KBD_USE, 121, 129

LOC_DRAG

, 120

LOC_MOVE

, 106, 120

LOC_WINENTER, 106, 120, 129

LOC_WINEXIT, 106, 120

MapNotify, 54

MS_LEFT, 126

realize, 55

SCROLLBAR_REQUEST, 264

WIN_ASCII_EVENTS

, 121

WIN_CIRCULATE_NOTIFY, 123

WIN_COLORMAP_NOTIFY, 120

WIN_CREATE_NOTIFY, 123

WIN_DESTROY_NOTIFY

, 123

WIN_GRAPHICS_EXPOSE, 122

WIN_GRAVITY_NOTIFY, 123

WIN_MAP_NOTIFY, 123

WIN_META_EVENTS, 106

WIN_NO_EXPOSE, 122

WIN_REPAINT, 81, 92, 122

WIN_REPARENT_NOTIFY, 123

WIN_RESIZE, 81, 122-123

WIN_STRUCTURE_NOTIFY, 123

WIN_SUBSTRUCTURE_NOTIFY, 123

WIN_UNMAP_NOTIFY, 123

WIN_UP_ASCII_EVENTS, 121

WIN_UP_EVENTS, 106, 121

WM_SAVE_YOURSELF, 495

XClientMessage, 116

XClientMessageEvent, 131

event handling, in

CANVAS package, 105

event_action macro, 126

event_button_is_down macro, 128

event-driven input handling, 460

event_id macro, 126

event_is_ascii macro, 127

event_is_button macro, 128

event_is_down macro, 126

event_is_iso macro, 127

event_is_key_bottom macro, 128

event_is_key_left macro, 128

event_is_key_right macro, 128

event_is_key_top macro, 128

event_is_up macro, 126

event_left_is_down macro, 128

event_middle_is_down macro, 128

event_right_is_down macro, 128

events, 9

about, 9, 116

classes of, 116

client, 509

communicating with client, 474

determining state of event, 126

differences between X and XView, 125

event ID, 117, 126

Event structure, 19, 124-126

event-to-action mapping, 117, 126;

default for panel items, 206

keyboard, 121

masks, 116, 138

modifier keys, 126

mouse, 121

posting, 475

posting destroy, 478

registering, 118

relationship to Notifier, 35

repaint, 81, 122

resize, 81, 122

semantic, 117

754 XView Programming Manual

events (cont’d)

XEvent structure, 125

event_string macro, 127

event_window macro, 125

event_xevent macro, 92

exclusive and nonexclusive choices, 171-172

exec system call, 482

exit function, 50, 570, 572

expanding size of canvas, 98

Expose event, 92

F

file chooser, about, 677

customization, 687

sorting, 686

file descriptors, use in Notifier, 479

File_chooser, object, 677

FILE_CHOOSER, package, 677

FILE_CHOOSER_ABBREV_VIEW attribute,

687

FILE_CHOOSER_APP_DIR attribute, 687

FILE_CHOOSER_AUTO_UPDATE

attribute,

688

FILE_CHOOSER_CD_FUNC

attribute, 683

FILE_CHOOSER_COMPARE_FUNC attribute,

684, 686

FILE_CHOOSER_CUSTOMIZE_OPEN attri-

bute, 688

FILE_CHOOSER_DIRECTORY attribute, 683

FILE_CHOOSER_DOC_NAME

attribute, 687

FILE_CHOOSER_EXTEN_FUNC attribute, 688

FILE_CHOOSER_EXTEN_HEIGHT

attribute,

688

FILE_CHOOSER_FILTER_FUNC attribute, 683

FILE_CHOOSER_FILTER_MASK

attribute,

684

FILE_CHOOSER_FILTER_STRING

attribute,

684

FILE_CHOOSER_HISTORY_LIST attribute,

687

FILE_CHOOSER_MATCH_GLYPH attribute,

685

FILE_CHOOSER_MATCH_GLYPH_MASK

attribute, 685

FILE_CHOOSER_NO_CONFIRM attribute, 683

FILE_CHOOSER_NOTIFY_FUNC

attribute, 683

FILE_CHOOSER_OPEN macro, 677

FILE_CHOOSER_SAVE macro, 677

FILE_CHOOSER_SAVEAS

macro, 677

FILE_CHOOSER_SAVE_TO_DIR attribute, 687

FILE_CHOOSER_SHOW_DOT_FILES, 687

FILE_CHOOSER_SHOW_DOT_FILES attri-

bute, 687

FILE_CHOOSER_TYPE attribute, 677

FILE_LIST, 688, 690

files, reading, 480

filtering, 685

FIOASYNC, 462

FIONBIO, 462

flow of control in Notifier-based programs, 36

font, FONT_FAMILY_DEFAULT, 372

FONT_FAMILY_DEFAULT_FIXEDWIDTH,

372

FONT_STYLE_DEFAULT

, 372

font conventions, xxxvi

font ID, 367

FONT package, 367-377

FONT_CHAR_HEIGHT attribute, 376

FONT_CHAR_WIDTH attribute, 376

FONT_DEFAULT_CHAR_HEIGHT attribute,

376

FONT_DEFAULT_CHAR_WIDTH attribute, 376

FONT_FAMILY

attribute, 371

FONT_FAMILY_DEFAULT font, 372

FONT_FAMILY_DEFAULT_FIXEDWIDTH

font,

372

FONT_INFO

attribute, 375

FONT_NAME attribute, 375

FONT_RESCALE_OF

attribute, 374

fonts, 25, 50, 367

creating, 368

dimensions, 375

family, 367, 371

rescaling, 374

scale, 367

scaling, 373

size, 367, 373

specifying font by name, 375

style, 367, 371

using xv_find, 368

WINDOW

attributes, 373

FONT_SCALE attribute, 373

fonts.h header file, 368

FONT_SIZE

attribute, 371, 373

FONT_SIZES_FOR_SCALE attribute, 373

FONT_STRING_DIMS attribute, 376

Font_string_dims structure, 376

FONT_STYLE

attribute, 372

FONT_STYLE_DEFAULT font, 372

footer,

FRAME_SHOW_FOOTER attribute, 65

of a frame, 63

fork system call, 482

Index 755