Volume 7B: XView Reference Manual

FRAME_NO_CONFIRM

Controls whether a notice is displayed when a frame is destroyed.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Frame

See Also: 4.2.4

FRAME_NTH_SUBFRAME

Gets the frame’s nth (from 1) subframe. Returns NULL if requested Subframe does not exist.

Return Type: Frame

Argument: int

Procs: get

Objects: Frame

Usage:

Frame frame;

frame = xv_get (base_frame, FRAME_NTH_SUBFRAME, 1);

See Also: 4.8,

FRAME_NTH_SUBWINDOW

FRAME_NTH_SUBWINDOW

Gets the frame’s nth (from 0) subwindow. Returns NULL if requested Subwindow does not exist.

Return Type: Xv_Window

Argument: int

Procs: get

Objects: Frame

See Also: 4.8,

FRAME_NTH_SUBFRAME

FRAME_PREVIOUS_ELEMENT

When set on a canvas, the focus is set to the view’s horizontal scrollbar, vertical scrollbar, or the last

element in the canvas.

Argument: None

Procs: set

Objects: Frame

FRAME_PREVIOUS_PANE

Set the input focus to the previous pane that can accept input focus.

Argument: None

Procs: set

Objects: Frame

FRAME_RIGHT_FOOTER

Specifies the right-justified footer. XView copies the string on set.

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Frame

See Also: FRAME_SHOW_FOOTER , FRAME_LEFT_FOOTER

66 XView Reference Manual

FRAME_SHOW_FOOTER

Indicates whether the footer is visible. The footer will inherit the colormap segment and foreground

color of the frame only if the colormap segment is a control colormap segment.

Argument: Bool

Default:

FALSE (TRUE for a FILE_CHOOSER object)

Procs: create, get, set

Objects: Frame

See Also: 4.2.2, FRAME_LEFT_FOOTER, FRAME_RIGHT_FOOTER, CMS_CONTROL_CMS

FRAME_SHOW_HEADER

Indicates whether the header is visible. This is only a hint to the window manager. Some window

managers may not honor this hint, some window managers may only honor this hint when the frame

leaves the withdrawn state. Thus, to see the effect of setting this attribute to FALSE, the frame may

need to be unmapped, and then mapped again.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Frame

See Also: 4.2.2

FRAME_SHOW_LABEL

Indicates whether the frame’s label is displayed. This is equivalent to

FRAME_SHOW_HEADER.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Frame

FRAME_SHOW_RESIZE_CORNER

Determines whether a frame has resize corners. This is only a hint to the window manager. Some

window managers may not honor this hint, some window managers may only honor this hint when

the frame leaves the withdrawn state. Thus, to see the effect of setting this attribute to

FALSE, the

frame may need to be unmapped, and then mapped again. This attribute has no effect on window

managers that are not

OPEN LOOK compliant.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Frame

See Also: 4.3.4

FRAME_WM_COMMAND_ARGC

Returns the number of command-line option strings stored on the frame.

Return Type: int

Default: 0

Procs: get

Objects: Frame

See Also: 4.11,

FRAME_WM_COMMAND_ARGC_ARGV, FRAME_WM_COMMAND_ARGV,

FRAME_WM_COMMAND_STRINGS

, WIN_CMD_LINE, Chapter 12, Interclient

Communication, in the Xlib Programming Manual.

XView Attributes

XView Attributes 67

FRAME_WM_COMMAND_ARGC_ARGV

Lets an application set the command-line options that can be used to (re)start it. The options passed,

in addition to XView options, are stored on a property called WM_COMMAND on the frame window. The

options passed are stored by XView and will be added to the XView options on the WM_COMMAND

property on the frame window, upon receiving a WM_SAVE_YOURSELF request from the session/win-

dow manager. The program xprop can be used to display a window’s properties. Only one base

frame window of the application needs to have this property set. This property is read possibly by a

session manager to restart clients. Setting this attribute’s arguments to

NULL and -1 prevents any com-

mand-line option information from being saved on the frame. If there are two or more base frames in

the application, the second and subsequent base frames should set their FRAME_WM_

COMMAND_ARGC_ARGV attributes’ arguments to

NULL and -1 if they want to avoid multiple invoca-

tions of the same application by the session manager. The first argument is the number of strings pas-

sed in the second argument. The second argument is a pointer to an array containing the command-

line option strings. The strings passed are copied and cached on the frame.

Argument1: int

Argument2: (char **)

Default: 0 for Argument1

NULL for Argument2

Procs: create,set

Objects: Frame

Usage:

Frame base_frame, second_frame;

char *argv[10];

int argc = 0;

argv[argc++] = "-I"

argv[argc++] = "ls"

argv[argc++] = "-bold_font"

argv[argc++] = "courier-bold-14"

/*

* This ensures that the above options are stored

* on the base frame

*/

xv_set(base_frame, FRAME_WM_COMMAND_ARGC_ARGV,

argc, argv, NULL);

/*

* This ensures that no command-line information will

* be stored on this frame.

*/

xv_set(second_frame,

FRAME_WM_COMMAND_ARGC_ARGV, NULL, -1, NULL);

See Also: 4.11, 20.9.8,

FRAME_WM_COMMAND_ARGV, FRAME_WM_COMMAND_ARGC,

FRAME_WM_COMMAND_STRINGS, WIN_CMD_LINE, Chapter 12, Interclient

Communication, in the Xlib Programming Manual.

68 XView Reference Manual

FRAME_WM_COMMAND_ARGV

Returns the array containing the command-line option strings stored on the frame. The strings in the

array must not be modified by client programs. If the value returned is -1, this means that no com-

mand-line information is stored on the frame.

Return Type: (char **) or -1

Default:

NULL

Procs: get

Objects: Frame

See Also: 4.11,

FRAME_WM_COMMAND_ARGC_ARGV, FRAME_WM_COMMAND_ARGC,

FRAME_WM_COMMAND_STRINGS, WIN_CMD_LINE, Chapter 12, Interclient

Communication, in the Xlib Programming Manual.

FRAME_WM_COMMAND_STRINGS

Lets an application set the command-line options that can be used to (re)start it. The options passed,

in addition to XView options are stored on a property called

WM_COMMAND on the frame window. The

options passed are stored by XView and will be added to the XView options on the WM_COMMAND

property on the frame window, upon receiving a WM_SAVE_YOURSELF request from the session/win-

dow manager. (The program xprop can be used to display a window’s properties.) Only one base

frame window of the application needs to have this property set. This property is read, possibly by a

session manager to restart clients. Setting this attribute to -1 prevents any command-line option infor-

mation from being saved on the frame. If there are two or more base frames in the application, the

second and subsequent base frames should set their

FRAME_WM_COMMAND_ARGC_ARGV attributes to -1

if they want to avoid multiple invocations of the same application by the session manager. The strings

passed are copied and cached on the frame.

Argument:

NULL-terminated list of (char *) or, -1 followed by NULL

Default: None

Procs: create,set

Objects: Frame

Usage:

Frame base_frame, second_frame;

/* Ensure that the given options are stored on

* on the base frame

*/

xv_set(base_frame, FRAME_WM_COMMAND_STRINGS,

"-I",

"ls",

"-bold_font",

"courier-bold-14",

NULL,

NULL);

/* This ensures that no command-line information will

* be stored on this frame.

*/

xv_set(second_frame, FRAME_WM_COMMAND_STRINGS,

-1, NULL, NULL);

See Also: 4.11,

FRAME_WM_COMMAND_ARGC_ARGV, FRAME_WM_COMMAND_ARGC,

FRAME_WM_COMMAND_ARGV, WIN_CMD_LINE, Chapter 12, Interclient Communication, in

the Xlib Programming Manual.

XView Attributes

XView Attributes 69

FRAME_X_ACCELERATOR

Specifies a window-level accelerator. The keysym in the first argument is used to call the procedure

in the second argument with the data in the third argument. On xv_get, the Frame package searches

through the linked list of accelerators, and returns a pointer to the Frame_accelerator structure

whose code or keysym matches the specified code and keysym. Applications do not normally use

xv_get with this attribute. Note: Certain key combinations are reserved for semantic actions within

XView and should not be used for accelerators. These key combinations are listed in Appendix C,

Mouseless Model Keyboard Mappings of the XView Programming Manual.

Argument 1: KeySym

Argument 2: void (*accelerator_notify_proc)()

Argument 3: Xv_opaque

Procs: create,get,set

Objects: Frame

Callback:

void

accelerator_notify_proc(value, event)

Xv_opaque value; /* from Argument 3 */

Event *event;

See Also: 6.14

FULLSCREEN_ALLOW_EVENTS

When in a fullscreen grab and the pointer and/or the keyboard is “frozen,” specifies how the events

that are queued up in the server due to X grabs, are processed.

Argument: int (where the value is any of the AllowEvents modes in <X11/X.h>)

Procs: create, set

Objects: Fullscreen

See Also: XAllowEvents(), Xlib Reference Manual.

FULLSCREEN_ALLOW_SYNC_EVENT

When in a synchronous grab mode, where the keyboard and/or pointer is frozen by a client; specifies

that normal event processing continue until the next mouse button or keyboard event.

Argument: No value

Procs: create, set

Objects: Fullscreen

FULLSCREEN_CURSOR_WINDOW

Restricts the cursor to a specified window. xv_get identifies the window.

Argument: Xv_window

Default: None

Procs: create, get

Objects: Fullscreen

FULLSCREEN_GRAB_KEYBOARD

Specifies whether keyboard should be grabbed.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Fullscreen

70 XView Reference Manual