Volume 7B: XView Reference Manual

FULLSCREEN_GRAB_POINTER

Specifies whether pointer should be grabbed.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_GRAB_SERVER

Specifies whether server should be grabbed.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_INPUT_WINDOW

Specifies the window from which input is read; xv_get identifies that window. The server, key-

board, and pointer are grabbed for this window.

Argument: Xv_window

Default: Owner window

Procs: create, get

Objects: Fullscreen

FULLSCREEN_KEYBOARD_GRAB_KBD_MODE

Determines the grab mode for the keyboard when grabbing the keyboard.

Argument: Fullscreen_grab_mode

Default:

FULLSCREEN_ASYNCHRONOUS

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_KEYBOARD_GRAB_PTR_MODE

Determines the grab mode for the pointer when grabbing the keyboard.

Argument: Fullscreen_grab_mode

Default:

FULLSCREEN_ASYNCHRONOUS

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_OWNER_EVENTS

When a window grabs the server/keyboard/pointer, the value of this attribute determines the distribu-

tion of events to the the application’s windows.

All events occurring outside all the application’s windows, are reported to the grab window (see

FULLSCREEN_INPUT_WINDOW

).

For events occurring within the application’s windows: If

FULSCREEN_OWNER_EVENTS is TRUE, the

events are reported to the window indicated by the pointer. If

FULSCREEN_OWNER_EVENTS is FALSE,

the events are reported to the grab window.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Fullscreen

XView Attributes

XView Attributes 71

FULLSCREEN_PAINT_WINDOW

Specifies or gets the paint window that will be or is already in fullscreen.

Argument: Xv_opaque

Default: Owner window

Procs: create, get

Objects: Fullscreen

FULLSCREEN_POINTER_GRAB_KBD_MODE

Determines the grab mode for the keyboard when grabbing the pointer.

Argument: Fullscreen_grab_mode

Default:

FULLSCREEN_ASYNCHRONOUS

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_POINTER_GRAB_PTR_MODE

Determines the grab mode for the pointer when grabbing the pointer.

Argument: Fullscreen_grab_mode

Default:

FULLSCREEN_ASYNCHRONOUS

Procs: create, get, set

Objects: Fullscreen

FULLSCREEN_RECT

Returns a pointer to the rectangle containing the paint window that is currently fullscreen.

Argument: Rect *

Default: Owner window’s bounding box

Procs: get

Objects: Fullscreen

FULLSCREEN_SYNC

Specifies whether to grab in synchronous (TRUE) or asynchronous (FALSE) mode.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Fullscreen

HELP_STRING_FILENAME

The name of a file containing a list of string pairs. The file is searched for in the directories listed in

the environment variable

HELPPATH. Each line in the file contains two words: the first word is the

help string for which help is available, and the second word is of the form file:target, which XView

uses to find the Spot Help text and More Help data. The first word must be less than 128 characters,

and the second less than 64 characters.

HELP_STRING_FILENAME is to be set on the paint window, or

any of its owners, where the strings are to be painted.

Argument: Char *

Default: No string-help available

Procs: create, get, set

Objects: Icon

See Also: 23.2.3

72 XView Reference Manual

HISTORY_ADD_FIXED_ENTRY

Add a string to the Fixed Space in the list. A Fixed String is always added to the bottom of the Fixed

Space in the list. Passing a label of NULL will add a blank Menu_item. This attribute takes a pair of

strings, the first of which is the label displayed in the Menu, and the second is the value of the menu

item associated with this entry.

Argument 1: char *

Argument 2: char *

Default: None

Procs: create, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_ADD_ROLLING_ENTRY

Add a string to the Rolling Space. Strings in the Rolling Space are stacked and will roll off after some

specified number of strings are added. This attribute takes a pair of strings, the first of which is the la-

bel displayed in the Menu, and the second is the value of the menu item associated with this entry.

Argument 1: char *

Argument 2: char *

Default: None

Procs: create, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_DUPLICATE_LABELS

Allow duplicate labels in the Rolling Space. Checks both Fixed and Rolling Space for duplicates.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_DUPLICATE_VALUES

Allow duplicate values in the Rolling Space. Checks both Fixed and Rolling Space for duplicates.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_FIXED_COUNT

Returns the number of entries currently in the Fixed Space.

Argument: int

Default: None

Procs: get

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

XView Attributes

XView Attributes 73

HISTORY_INACTIVE

Sets/Gets the Inactive state for a specified row. The first argument is one of HISTORY_FIXED or HIS-

TORY_ROLLING. The second argument is the row number, and the third argument is the state of the

flag (set only). If the row does not exist, the xv_set call is ignored, or the xv_get call will return

-1.

Argument 1: enum

Argument 2: int

Argument 3: int

Default:

FALSE

Procs: get, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_LABEL

Returns the value or label from a specified space (defined HISTORY_FIXED or HISTORY_ROLLING),

for a specified row number. If the specified row does not exist, NULL will be returned.

Argument 1: enum

Argument 2: int

Default: None

Procs: get

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_MENU_HISTORY_LIST

Specifies the HISTORY_LIST object that is associated with this HISTORY_MENU instance.

Argument: History_list

Default:

NULL

Procs: create, get, set

Objects: History_menu

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_MENU_OBJECT

Retrieves the handle to the internal Menu. Note: the only supported use of this handle is to pass it to

menu_show() or to another XView object (such as a

PANEL_BUTTON) for it’s menu argument.

Argument: No value

Procs: get

Objects: History_menu

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_NOTIFY_PROC

The callback invoked by the user’s selection on the HISTORY_MENU.

Argument: int (*)()

Default:

NULL

Procs: create, get, set

Objects: History_menu

74 XView Reference Manual

Callback:

void

callback ( hm, label, value )

History_menu hm;

char * label;

char * value;

HISTORY_ROLLING_COUNT

Returns the number of entries currently in the Rolling Space.

Argument: int

Default: None

Procs: get

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_ROLLING_MAXIMUM

Specifies the maximum strings in the Rolling Space before roll off actually occurs.

Argument: int

Default: 15

Procs: create, get, set

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

HISTORY_VALUE

Returns the value or label from a specified space (defined HISTORY_FIXED or HISTORY_ROLLING),

for a specified row number. If the specified row does not exist,

NULL will be returned.

Argument 1: int

Argument 2: int

Default: None

Procs: get

Objects: History_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

ICON_FONT

Specifies the icon’s font.

Argument: Xv_font

Default: lucida medium

Procs: create, get, set

Objects: Icon

ICON_HEIGHT

Icon’s height in pixels.

Argument: int

Default: 64

Procs: create, get, set

Objects: Icon

XView Attributes

XView Attributes 75