Volume 7A: XView Programming Manual

Server object, 353

SERVER package, 353

SERVER_ATOM attribute, 355

SERVER_ATOM_NAME attribute, 355

server-client model, 5

SERVER_EXTENSION_PROC attribute, 138

SERVER_EXTERNAL_XEVENT_MASK attri-

bute, 139

SERVER_EXTERNAL_XEVENT_PROC attri-

bute, 139

server.h header file, 353

SERVER_IMAGE package, 356

SERVER_IMAGE_BITMAP_FILE attribute, 357

SERVER_IMAGE_BITS attribute, 356

SERVER_IMAGE_CMS attribute, 357

SERVER_IMAGE_DEPTH attribute, 357

SERVER_IMAGE_PIXMAP

attribute, 357

SERVER_IMAGE_SAVE_PIXMAP attribute,

357

SERVER_IMAGE_X_BITS attribute, 356

SERVER_NTH_SCREEN attribute, 351

SERVER_SYNC_AND_PROCESS_EVENTS

attribute, 355

setjmp system call, 509

setpriority system call, 509

setquota system call, 509

settimer system call, 462

shelf, 637

sigaction (2), 462

SIGALRM

, 464

sigblock system call, 509

SIGCHLD

, 464, 471

SIGIO, 465

sigmask system call, 509

signal handling, 464

signal system call, 461, 486

replacement for, 465

signal.h header file, 465

sigpause system call, 509

sigstack system call, 509

SIGTERM, 464, 470, 478

SIGURG, 465

sigvec (2), 462

sigvec system call, 509

SIGVTALRM system call, 464

sleep(), emulating, 502

slider item, 186

selection, 187

soft function keys, 140

split views, about, 29

function of scrollbar, 254

in a text subwindow, 232

in canvas, 102

static subclassing, 19

structure, Display, 350

Event, 19, 124

Font_string_dims, 376

Inputmask, 119, 131-132

Rect, 19, 66

Rectlist, 19, 95

Screen, 350

Seln_request, 639, 641

XEvent, 125

XFontStruct, 375

XTextExtents, 376

Xv_Screen, 350

subclass, definition of, 580

subclassing, static, 580

subframe, 61, 68

subwindows, about, 29

laying out in frames, 77

SunView, 11

graphics, 91

svrimage.h header file, 356

system call, alarm, 462

calls to avoid, 462

dup2, 482

exec, 482

fork, 482

getitimer, 462

ioctl, 462

pclose, 462

pipe, 482

popen, 462

read, 479

readv, 509

rlimit, 509

setjmp, 509

setpriority, 509

setquota, 509

settimer, 462

sigblock, 509

sigmask, 509

signal, 461, 486

sigpause, 509

sigstack, 509

sigvec, 509

SIGVTALRM, 464

system, 462, 482

umask, 509

wait, 462

wait3, 462, 471

write, 479, 509

system system call, 462, 482

766 XView Programming Manual

T

terminal emulator, (See TTY subwindow).

text item, 164, 188

ASCII events, 206

multiline, 193

notification, 191

numeric, 193

selection, 190

text subwindow, about, 30, 215

checking status, 218

confirmation, 233

contents of, 216

creating, 216

deleting text, 220

destruction, 233

determining what lines are visible, 227

discarding edits, 224

edit log, 222

editing, 217

emulating an editing character, 221

getting a text selection, 231

getting filename, 222

index, 216

interaction with file system, 223

interposition, 236

lines on screen and in file, 226

loading a file, 217

marking positions, 230

notification, 233

pattern matching, 228

positioning text, 226

positioning views, 226

reading from, 219

replacing characters, 221

saving edits, 223

scrolling, 227

setting initial contents, 224

setting insertion point, 219

split views, 232

storing edits, 223

subclassed from

OPENWIN, 216

undo, 222

use of clipboard, 220

veto destroy, 233

writing to, 219

text subwindow package, (see

TEXTSW pack-

age)

text-based programs, 90

TEXTSW package, 215-236

Textsw_action attributes, 234

TEXTSW_ACTION_CAPS_LOCK attribute, 234

TEXTSW_ACTION_CHANGED_DIRECTORY

attribute, 234

TEXTSW_ACTION_EDITED_FILE attribute,

234-235

TEXTSW_ACTION_EDITED_MEMORY attri-

bute, 234

TEXTSW_ACTION_FILE_IS_READONLY attri-

bute, 234

TEXTSW_ACTION_LOADED_FILE attribute,

234-235

TEXTSW_ACTION_TOOL_CLOSE attribute,

234

TEXTSW_ACTION_TOOL_DESTROY attribute,

234

TEXTSW_ACTION_TOOL_MGR

attribute, 234

TEXTSW_ACTION_TOOL_QUIT

attribute, 234

TEXTSW_ACTION_USING_MEMORY attri-

bute, 234

textsw_add_mark procedure, 230

textsw_append_file_name procedure, 222

TEXTSW_CONTENTS

attribute, 220, 225

textsw_delete procedure, 220

textsw_edit procedure, 221

textsw_erase procedure, 220-221

TEXTSW_FILE

attribute, 217

TEXTSW_FILE_CONTENTS attribute, 224

textsw_file_lines_visible procedure, 227

textsw_find_bytes procedure, 228

textsw_find_mark procedure, 231

TEXTSW_FIRST attribute, 217

textsw_first procedure, 232

TEXTSW_FIRST_LINE

attribute, 227

TEXTSW_FONT attribute, 216

TEXTSW_FOR_ALL_VIEWS

attribute, 226

textsw.h header file, 216

TEXTSW_IGNORE_LIMIT

attribute, 233

Textsw_index type, 216

textsw_index_for_file_line procedure, 227

TEXTSW_INFINITY

value, 219-220

textsw_insert procedure, 219

TEXTSW_INSERT_FROM_FILE attribute, 225

TEXTSW_INSERTION_POINT attribute, 219

TEXTSW_INSERT_MAKES_VISIBLE attribute,

219, 228

TEXTSW_LENGTH attribute, 216

TEXTSW_LINE_BREAK_ACTION

attribute,

226

textsw_match_bytes procedure, 229

TEXTSW_MEMORY_MAXIMUM

attribute, 222

TEXTSW_MODIFIED attribute, 217

textsw_next procedure, 232

textsw_normalize_view procedure, 228

Index 767

TEXTSW_NOTIFY_PROC attribute, 233

textsw_possibly_normalize procedure, 228

textsw_remove_mark procedure, 231

textsw_replace_bytes procedure, 222

textsw_reset procedure, 224

textsw_save procedure, 219, 223

textsw_screen_line_count procedure, 227

textsw_scroll_lines procedure, 227

textsw_set_selection procedure, 232

TEXTSW_STATUS attribute, 216, 218, 225

TEXTSW_STORE_CHANGES_FILE attribute,

223

textsw_store_file procedure, 219, 223

TEXTSW_WRAPAROUND_SIZE attribute, 222

tiled windows, definition of, 29

timeFormat resources, 541

timers, 467

toggle_notify procedure, 291

toolkit, (See X Window System, XView)

triggers, 318, 659

TTY subwindow, about, 241

creating, 241

escape sequences, 243

input and output routines, 243

monitoring, 246

under program control, 242

TTY_ARGV attribute, 241, 246-247

tty.h header file, 241

TTY_PID attribute, 247

TTY_QUIT_ON_CHILD_DEATH

attribute, 246

TTYSW package, 241

ttysw_input procedure, 242

ttysw_output procedure, 243

TTY_TTY_FD

attribute, 247

type, about, 19

Attr_attribute, 582-583

Attr_avlist, 583

defined in XView, 43

Screen, 350

Textsw_index, 216

Window_rescale_state, 373

XColor, 518

XErrorEvent, 570

Xv_Cursor, 327

Xv_Font, 368

Xv_object, 19, 49

Xv_opaque, 19

Xv_pkg, 572, 589

Xv_singlecolor, 333

typecasting, 52

U

umask system call, 509

UNIX facilities used by applications, 462

UNIX system calls and XView, 462

user interface components, 7

user interface standards, 12

V

Version 3, 12

view window, 86

definition of, 85

views, (See split views).

virtual keyboards, 140

internationalization, 140

language support, 140

visualization programs, 90

W

wait system call, 462

wait3 function, 246

wait3 system call, 462, 471-472

widget sets, 7

WIN_ASCII_EVENTS

event, 121

WIN_BACKGROUND_COLOR attribute, 75,

521

WIN_BIT_GRAVITY attribute, 94

WIN_CIRCULATE_NOTIFY

event, 123

WIN_CLIENT_DATA attribute, 199

WIN_CMS

attribute, 513, 519, 524

WIN_CMS_NAME attribute, 519

WIN_COLLAPSE_EXPOSURES

attribute, 92,

122

WIN_COLORMAP_NOTIFY event, 120

WIN_CONSUME_EVENT attribute, 106, 119

WIN_CONSUME_EVENTS

attribute, 119

WIN_CONSUME_X_EVENT_MASK attribute,

118

WIN_CREATE_NOTIFY event, 123

WIN_DEPTH attribute, 25, 528

WIN_DESTROY_NOTIFY

event, 123

window manager, authority of, 9

definition, 9

hints, 61

role of, 61

window_fit macro, 77, 164

window_fit_height macro, 77, 164

window_fit_width macro, 77, 164

Window_rescale_state type, 373

768 XView Programming Manual

windows, as objects, 25

creation, 55

win_event.h header file, 119, 125

WIN_EVENT_PROC attribute, 106, 124

WIN_EXTEND_TO_EDGE, 25

WIN_FOREGROUND_COLOR attribute, 75,

521

WIN_GRAB_ALL_INPUT attribute, 130

WIN_GRAPHICS_EXPOSE event, 122

WIN_GRAVITY_NOTIFY event, 123

WIN_IGNORE_EVENT attribute, 120

WIN_IGNORE_EVENTS attribute, 120

WIN_IGNORE_X_EVENT_MASK attribute, 118

win_input.h header file, 119, 124-125

WIN_INPUT_MASK attribute, 132

WIN_MAP_NOTIFY event, 123

WIN_MESSAGE_DATA

attribute, 131

WIN_MESSAGE_FORMAT attribute, 131

WIN_MESSAGE_TYPE attribute, 131

WIN_META_EVENTS event, 106

WIN_MOUSE_XY attribute, 330

WIN_NO_CLIPPING

attribute, 95

WIN_NO_EVENTS, 120

WIN_NO_EXPOSE

event, 122

WIN_NOTIFY_IMMEDIATE_EVENT_PROC

attribute, 598

WIN_NOTIFY_SAFE_EVENT_PROC attribute,

598

WIN_REPAINT event, 81, 92, 122

WIN_REPARENT_NOTIFY

event, 123

WIN_RESIZE event, 81, 122-123

WIN_RETAINED

attribute, 88, 101, 204

WIN_SCALE_EXTRALARGE, 373

WIN_SCALE_LARGE

, 373

WIN_SCALE_MEDIUM, 373

WIN_SCALE_SMALL, 373

win_set_kbd_focus procedure, 129

WIN_SOFT_FNKEY_LABELS attribute, 141

WIN_STRUCTURE_NOTIFY

event, 123

WIN_SUBSTRUCTURE_NOTIFY

event, 123

WIN_TOP_LEVEL_NO_DECOR attribute, 78

WIN_UNMAP_NOTIFY event, 123

WIN_UP_ASCII_EVENTS event, 121

WIN_UP_EVENTS event, 106, 121

WIN_WINDOW_GRAVITY attribute, 94

WIN_X_COLOR_INDICES attribute, 520

WM_SAVE_YOURSELF

event, 495

write system call, 479, 509

X

X Protocol, 6

X Window ID, (See XV_XID attribute).

X Window System, events, 92;

differences between X and XView, 125

extensibility, 8

interclient communications, 9, 393, 433, 635

overview, 3

protocol, 6

role of window manager, 9

server and client relationship, 5

software hierarchy, 7

specifying event masks, 118

toolkits, 7

X Window ID for paint window, 94

Xlib, 7

XAllocColor function, 518

XAllocColor procedure, 515

XAllocColorCells function, 518

XClientMessage event, 116

XClientMessageEvent event, 131

XColor type, 518

XCopyPlane procedure, 259

XDefaultColormap macro, 515

XErrorEvent type, 570

XEvent structure, 125

XFontStruct structure, 375

XGrabPointer procedure, 279

X.h header file, 119

Xlib, 7

repainting canvas, 95

using to draw, example, 333

Xlib.h header file, 96, 350

XLookupString procedure, 127

XNextEvent procedure, 131

XParseColor function, 517

XRebindKeysym procedure, 125, 127

XSendEvent procedure, 116, 130

XStoreColor function, 517

XStoreColors function, 518

XTextExtents structure, 376

xv_add_custom_attrs() procedure, 587

xv_alloc macro, 596

XV_APP_NAME

attribute, 563

XV_ATTR macro, 583

XV_AUTO_CREATE attribute, 297, 612

xv_calloc function, 596

xv_check_bad_attr function, 586, 608

xv_col procedure, 163

xv_create procedure, 47

compared to xv_find(), 50

Xv_Cursor type, 327

Index 769

XV_DECREMENT_REF_COUNT attribute, 169

XV_DEFAULT_CMS_SIZE macro, 516

xv_default_server global variable, 353

xv_destroy procedure, 50, 155

used for frames, 79

xv_destroy_safe procedure, 50, 200, 479

XV_DISPLAY attribute, 350, 513

XV_DYNAMIC_CMS, 515

XV_END_CREATE attribute, 581, 600

XV_ERROR, 52

xv_error function, 567, 608

xv_error_format procedure, 568

xv_error.h header file, 570

XV_ERROR_PROC attribute, 568

xv_find, colormap segments, 527

procedure, 49

Xv_Font type, 368

xv_get procedure, 51

XV_HEIGHT attribute, 355

XV_HELP_DATA attribute, 558

xv_help_show function, 561

XView, about, 3, 7, 9, 11-12

as object-oriented system, 17

compiling programs, 41

concept of windows differs from X, 25

data types, table of, 20

example of programming interface, 43

File Chooser, 677-702

frames and subframes, 26

generic functions, 21

Generic Object, 19, 24

internals, 579-632

libraries, 42

notification, 9, 35

object class hierarchy, 18

objects, 23-24;

and owners, table of, 20;

list of, 43

overview, xxxiii

packages, 18, 43

programmer’s model, 17-23

programming interface, 41

programs, initialization, 45, 62

reserved names, 43

reserved prefixes, 43

structure of applications, 41

subwindows, 29

types, 43

Version 3.2, 677-702

window objects, 25

xview locale attributes, 540

xview.h header file, 42

XV_INCREMENT_REF_COUNT attribute, 169

xv_init procedure, 45, 62, 353

XV_INIT_ARGC_PTR_ARGV attribute, 46, 63

XV_INIT_ARGS attribute, 46, 63

XV_INIT_ARGS macro, 46

xv_input_readevent procedure, 119, 131, 361

XV_INSTANCE_NAME attribute, 390, 551

XV_KEY_DATA attribute, 199, 282

XV_KEY_DATA_REMOVE attribute, 202

XV_KEY_DATA_REMOVE_PROC attribute,

201

XV_LABEL attribute, 64, 344

XV_LC_BASIC_LOCALE attribute, 540

XV_LC_DISPLAY_LANG attribute, 540

XV_LC_INPUT_LANG

attribute, 540

XV_LC_NUMERIC

attribute, 540

XV_LC_TIME_FORMAT

attribute, 540

XV_LOCALE_DIR attribute, 539, 547, 550

xv_main_loop procedure, 54, 498

XV_NAME attribute, 353

XV_OBJECT, 19

Xv_object type, 19, 49

Xv_opaque type, 19

Xv_pkg type, 572, 589

XV_PRIVATE macro, 593

XV_PUBLIC

macro, 593

XV_RECT attribute, 582

XV_REF_COUNT

attribute, 169

xv_row procedure, 163

Xv_Screen, 350, 516

XV_SCREEN attribute, 350, 354

xv_send_message procedure, 116, 130

XV_SERVER_FROM_WINDOW

macro, 138

xv_set procedure, 51

XV_SHOW

attribute, 69, 498

Xv_singlecolor attribute, 517

Xv_singlecolor type, 333

XV_STATIC_CMS, 515

XV_TYPE

attribute, 572

XV_USAGE_PROC

attribute, 46

XV_USE_DB attribute, 390, 551, 588

XV_USE_LOCALE attribute, 537-538

XV_VISUAL attribute, 528

XV_VISUAL_CLASS attribute, 528

XV_WIDTH attribute, 355

xv_window_loop procedure, 77

xv_window_return procedure, 77

XV_X attribute, 162

XV_X_ERROR_PROC attribute, 569

to xv_init(), 569

XV_XID attribute, 94, 368

Xv_xrectlist, 97

XV_Y

attribute, 162

770 XView Programming Manual