Volume 7B: XView Reference Manual

Callback:

void

accelerator_notify_proc(value, event)

Xv_opaque value; /* from Argument 3 */

Event *event;

See Also: 6.14

FRAME_BACKGROUND_COLOR

This attribute is obsolete. To change a frame’s background color, create a cms and set it on the frame.

FRAME_BUSY

Sets label to gray and changes cursor to hour-glass.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Frame

See Also: 4.5

FRAME_CLOSED

Controls the frame’s mapped state (either open or iconic).

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Frame

See Also: 14.2,

XV_SHOW

FRAME_CLOSED_RECT

Sets the size of the frame’s icon. To comply with the normal window manager placement strategy, if

only the size of the icon is being set and not its screen location, first get the current

FRAME_CLOSED_RECT

rect and use the retrieved rect.r_top and rect.r_left values in the

call to set FRAME_CLOSED_RECT.

Argument: Rect *

Default: rect.r_width = 64

rect.r_height = 64

rect.r_left = window manager dependent value

rect.r_top = window manager dependent value

Procs: create, get, set

Objects: Frame

See Also: 4.2.3

FRAME_CMD_DEFAULT_PIN_STATE

This attribute controls the initial state of the pin when the frame goes from unmapped (withdrawn) to

mapped state. It is valid for both mapped and unmapped frames. However, if the frame is currently

mapped, the effects of the change will be visible only on the next transition from unmapped to

mapped state.

Argument: int

Valid Values: {

FRAME_CMD_PIN_IN, FRAME_CMD_PIN_OUT} defined in <xview/frame.h> .

Procs: create,get,set

Objects: Frame_cmd

See Also: 4.3.2,

FRAME_CMD_PIN_STATE

XView Attributes

XView Attributes 61

FRAME_CMD_PANEL

Gets the default panel in the command frame.

Return Type: Panel

Procs: get

Objects: Frame

See Also: 11.12

FRAME_CMD_PIN_STATE

This attribute returns the current state of the pin. It is valid for both mapped and unmapped frames.

Though, for unmapped frames it will always return

FRAME_CMD_PIN_OUT.

Argument: int

Valid Values: {

FRAME_CMD_PIN_IN, FRAME_CMD_PIN_OUT}defined in <xview/frame.h>

Procs: get, set

Objects: Frame_cmd

See Also: 4.3.2,

FRAME_CMD_DEFAULT_PIN_STATE

FRAME_CMD_PUSHPIN_IN

This attribute is obsolete. It is supported only for compatibility reasons. Applications should use

FRAME_CMD_DEFAULT_PIN_STATE and FRAME_CMD_PIN_STATE instead. Indicates whether the

pushpin is in or out.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Frame

See Also:

FRAME_CMD_PIN_STATE

FRAME_DEFAULT_DONE_PROC

The default procedure is to set the subframe to

WIN_SHOW, FALSE.

Default:

FRAME_DEFAULT_DONE_PROC

Procs: create, get, set

Objects: Frame

See Also: 4.3.3,

FRAME_DONE_PROC

FRAME_DONE_PROC

Names a procedure to be called when the command frame is dismissed by the user (by taking the

pushpin out).

Argument: void (*frame_done_proc)()

Default:

FRAME_DEFAULT_DONE_PROC

Procs: create, get, set

Objects: Frame

Callback:

void

frame_done_proc(frame)

Frame frame;

See Also: 4.3.3

62 XView Reference Manual

FRAME_FOCUS_DIRECTION

The direction in which the Location Cursor is pointing.

Argument: Frame_focus_direction(enum)

Valid Values: {

FRAME_FOCUS_RIGHT, FRAME_FOCUS_UP}

Procs: create,set,get

Objects: Frame

See Also: 6.13.4

FRAME_FOCUS_WIN

Returns the handle of the Location Cursor (focus) window.

Return Type: Xv_window

Procs: get

Objects: Frame

See Also: 6.13.4

FRAME_FOREGROUND_COLOR

This attribute is obsolete. To change a frame’s foreground color, create a cms and set it on the frame.

FRAME_ICON

Identifies the base frame’s icon.

Argument: Xv_opaque

Default: A default empty icon.

Procs: create, get, set

Objects: Frame

See Also: 4.2.3

FRAME_INHERIT_COLORS

This attribute is obsolete. To implement this functionality, use WIN_INHERIT_COLORS on the frame.

FRAME_LABEL

Specifies the label used in the window manager’s titlebar for the frame. XView copies the string on

set.

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Frame

See Also: 4.2.2,

FRAME_SHOW_LABEL

FRAME_LEFT_FOOTER

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

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Frame

See Also:

FRAME_SHOW_FOOTER, FRAME_RIGHT_FOOTER

XView Attributes

XView Attributes 63

FRAME_MAX_SIZE

This attribute is similar to FRAME_MIN_SIZE, but allows the application programmer to specify a

maximum size the frame can be resized to by a user. All other aspects of this attribute are exactly the

same as FRAME_MIN_SIZE.

Return Type: void

Argument 1: int (maximum width of frame)

Argument 2: int (maximum height of frame)

Default: The default value is 0. In other words there is no application specified minimum or maxi-

mum size. Keep in mind that the window manager may impose one though.

Procs: create,get,set

Objects: Frame

See Also: 4.3.5

FRAME_MENUS

For create and set, this replaces current menu list with the one passed on the avlist. For get,

this returns the current list of menus. The list returned should not be modified by the application. The

number of menus can be obtained with

FRAME_MENU_COUNT.

Argument: Null terminated list of Menus. On get, this returns (Menu *).

Default: None

Procs: create, get, set

Objects: Frame

Usage:

xv_set(frame1, FRAME_MENUS, edit_menu, load_menu,

NULL,

NULL);

FRAME_MENU_COUNT

Returns the current number of menus registered on the frame using FRAME_MENUS,

FRAME_MENU_ADD

, or FRAME_MENU_DELETE.

Argument: int

Default: None

Procs: get

Objects: Frame

Usage:

int menu_count;

menu_count = (int)xv_get(frame2, FRAME_MENU_COUNT);

FRAME_MENU_ADD

Appends to the list of accelerated menus on the frame.

Argument: Menu

Default: None

Procs: create, set

Objects: Frame

Usage:

xv_set(frame1,

FRAME_MENU_ADD, print_menu,

NULL);

64 XView Reference Manual

FRAME_MENU_DELETE

Deletes from the list of accelerated menus on the frame.

Argument: Menu

Default: None

Procs: create, set

Objects: Frame

Usage:

xv_set(frame1,

FRAME_MENU_DELETE, print_menu,

NULL);

FRAME_MIN_SIZE

This attribute allows the application programmer to specify a minimum size a frame can be resized to

by a user. The

FRAME_MIN_SIZE attribute takes two integer parameters, specifying the minimum

width and height of the

WM_NORMAL_HINTS property. Note that the minimum size is only a hint to the

window manager. Some window managers may choose to ignore certain application specified hints.

Setting both the minimum width and height to 0 effectively removes any application controlled mini-

mum restriction on size.

Return Type: void

Argument 1: int (minimum width of frame)

Argument 2: int (minimum height of frame)

Default: The default value is 0. In other words there is no application specified minimum or maxi-

mum size. Keep in mind that the window manager may impose one .

Defaults to a pre-determined number of rows and columns for a

FILE_CHOOSER. It is

recommended that clients who extend the FILE_CHOOSER update the FRAME_MIN_SIZE

accordingly. Note: the client may increase the min size of the Frame, but decreasing it

below the default values is not supported. Should not be set at create time for a File

Chooser.

Procs: create,get,set

Objects: Frame

Usage: To get the previous set values of

FRAME_MIN_SIZE use xv_get() and pass in two

parameters:

int width, height;

(void)xv_get(frame, FRAME_MIN_SIZE, &width, &height);

Note that some window managers may choose to ignore changes to the WM_

NORMAL_HINTS property on frames that are already mapped. Thus, depending on the

window manager, it may be necessary to unmap and then remap the frame before the

FRAME_MIN_SIZE values take effect.

See Also: 4.3.5

FRAME_NEXT_PANE

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

Argument: None

Valid Values: {

FRAME_FOCUS_RIGHT, FRAME_FOCUS_UP}

Procs: set

Objects: Frame

XView Attributes

XView Attributes 65