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

Get Volume 7B: XView Reference Manual now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.