PANEL_MAX_VALUE
Specifies the maximum value of the slider, gauge, or numeric text item.
Argument: int
Default: 100
Procs: create, get, set
Objects: Panel_numeric_text_item, Panel_gauge_item, Panel_slider_item
See Also: 7.13
PANEL_MAX_VALUE_STRING
Maximum value string for the slider. On horizontal sliders, the maximum value string appears to the
right of the maximum end box. On vertical sliders, the maximum value string appears above the max-
imum end box. The string is copied when this attribute is set.
Argument: char *
Default: No maximum value string
Procs: create,get,set
Objects: Panel_slider_item
See Also: 7.13
PANEL_MIN_TICK_STRING
String which appears underneath the minimum tick mark on horizontal sliders or gauges, or to the
right of the minimum tick mark on vertical sliders or gauges. If
PANEL_TICKS is 0
PANEL_MIN_TICK_STRING
is ignored. The width of the slider or gauge may be adjusted to insure
that there is enough space to accommodate both the minimum and maximum tick strings. The string
is copied when this attribute is set.
Argument: char *
Default: No minimum tick string
Procs: create, get, set
Objects: Panel_slider_item, Panel_gauge_item
See Also: 7.13
PANEL_MIN_VALUE
Specifies the minimum value of the slider, gauge, or numeric text item.
Argument: int
Default: 0
Procs: create, get, set
Objects: Panel_slider_item, Panel_numeric_text_item, Panel_gauge_item
See Also: 7.13
PANEL_MIN_VALUE_STRING
Minimum value string for the slider. On horizontal sliders, the minimum value string appears to the
left of the minimum end box. On vertical sliders, the minimum value string appears below the mini-
mum end box. The string is copied when this attribute is set.
Argument: char *
Default: No minimum value string
Procs: create, get, set
Objects: Panel_slider_item
See Also: 7.13
116 XView Reference Manual
PANEL_NCHOICES
Returns the number of choices available in a choice or toggle item.
Return Type: int
Procs: get
Objects: Panel_choice_item
See Also: 7.10
PANEL_NEXT_COL
This attribute is used when the panel layout is PANEL_VERTICAL. It specifies that the item is to start a
new column and specifies the amount of white space (in pixels) between the last column and the next
(new) column. If you specify –1, the default gap (PANEL_ITEM_X_GAP) is used.
Argument: Panel_item
Default: None
Procs: create
Objects: Panel_item
See Also: 7.3.1
PANEL_NEXT_ITEM
Gets the handle of the next item on a panel.
Argument: Panel_item
Procs: get
Objects: Panel_item
Usage:
next_item = xv_get(this_item, PANEL_NEXT_ITEM);
See Also: 7.7
PANEL_NEXT_ROW
This attribute is used when the panel layout is
PANEL_HORIZONTAL. It specifies that the item is to
start a new row and specifies the amount of white space (in pixels) between the last row and the next
(new) row. If you specify –1, the default gap (
PANEL_ITEM_Y_GAP) is used.
Argument: Panel_item
Default: None
Procs: create
Objects: Panel_item
See Also: 7.3.1
PANEL_NO_REDISPLAY_ITEM
This flag is useful if you intend to call xv_super_set_avlist() at the beginning of the set rou-
tine. Setting this attribute to
TRUE prevents the parent panel from redisplaying while the attributes are
being set. This attribute should be reset to FALSE after the call to xv_super_set_avlist().
Warning: This attribute should only be used from within a panel item extension.
Argument: Bool
Procs: get,set
Objects: Panel
See Also: 25.11.6
XView Attributes
XView Attributes 117
PANEL_NOTIFY_LEVEL
Specifies when to call the notify function. The valid values are PANEL_ALL, PANEL_NONE,
PANEL_SPECIFIED, and PANEL_NON_PRINTABLE. For sliders, any setting other than PANEL_ALL re-
sults in notification only on SELECT-up.
Argument: Panel_setting
Valid Values: {
PANEL_ALL, PANEL_NONE , PANEL_SPECIFIED, PANEL_NON_PRINTABLE}
Default: PANEL_SPECIFIED
Procs: create, get, set
Objects: Panel_numeric_text_item, Panel_multiline_text_item, Panel_slid-
er_item, Panel_text_item
See Also: 7.13.2
PANEL_NOTIFY_PROC
Procedure to call when a panel item is activated.
Argument: Variessee callbacks below
Default:
NULL
Procs: create, get, set
Objects: Panel_item
Callback: (For Button Items)
void
notify_proc(item, event)
Panel_item item;
Event *event;
Client-specified callback routine invoked when the user activates the button (accepts pre-
view).
Callback: (For Message Items)
void
notify_proc(item, event)
Panel_item item;
Event *event;
Client-specified callback routine invoked when the user activates the message (accepts
preview).
Callback: (For Text Items, Numeric Text Items, and Multiline Text Items)
Panel_setting
notify_proc(item, event)
Panel_item item;
Event *event;
Client-specified callback routine invoked when the user activates the text (accepts pre-
view). For text, numeric text, and multiline text items, the return value type is
Panel_setting and is one of
PANEL_INSERT, PANEL_NEXT, PANEL_NONE, or
PANEL_PREVIOUS.
118 XView Reference Manual
Callback: (For Exclusive Choice Items and Slider Items)
void
notify_proc(item, value, event)
Panel_item item;
int value;
Event *event;
Client-specified callback routine invoked when the user activates the exclusive choice or
slider (accepts preview).
Callback: (For Non-exclusive Choice Items, toggles)
void
notify_proc(item, value, event)
Panel_item item;
unsigned int value;
Event *event;
Client-specified callback routine invoked when the user activates the non-exclusive
choice (accepts preview). The value parameter is of type unsigned int because it
represents a mask of choices that are selected. For example, if the first and third items are
selected, then the first and third bits in the value parameter are onthis value happens
to be five.
Callback: (For List Items)
int
notify_proc(item, string, client_data, op, event, row)
Panel_item item;
char *string;
Xv_opaque client_data;
Panel_list_op op;
Event *event;
int row;
Client-specified callback routine invoked when the user activates the list item (accepts
preview).
string is the string associated with the row.
client_data is the client data associated with the row.
op indicates a select, validate, or delete operation. Of these, only PANEL_LIST_OP_
VALIDATE requires a return value.
row indicates the row in the scrolling list. Returns
XV_OK to validate a change or XV_
ERROR to invalidate a change.
Callback: (For Drop Target Item)
int
notify_proc(item, event)
Panel_item item;
Event *event;
A return value of
XV_OK indicates that XView should call dnd_done(). A return value
of XV_ERROR indicates that XView should not call dnd_done().
XView Attributes
XView Attributes 119
Callback: (For Path Name Items)
Panel_setting
notify_proc(item, event, stat_buf)
Path_name item;
Event * event;
struct stat * stat_buf;
Same as for
PANEL_TEXT, except that the PATH_NAME package passes in the pointer to a
stat structure as well as the item and event handles.
Callback: (For a File_list)
int
notify_proc( item, dir, file, client_data,
op, event, row )
File_list item;
char *dir;
char *file;
Xv_opaque client_data;
Panel_list_op op;
Event *event;
int row;
Note: the client_data field is added either by the client explicitly setting
PANEL_LIST_CLIENT_DATA(S) or by returning the value from the FILE_LIST_
FILTER_FUNC.
The op
PANEL_LIST_OP_DBL_CLICK, supports the PANEL_LIST package for applica-
tions that want to detect a double-click condition. This behavior is selected using the
attribute
PANEL_LIST_DO_DBL_CLICK which defaults to FALSE for the PANEL_LIST
package (for compatibility reasons) but defaults to TRUE for the FILE_LIST package.
The
FILE_LIST package intercepts the PANEL_LIST_OP_DBL_CLICK condition in cases
where the user double-clicks on a directory name. The client only sees the double-click
op if it occurred on a file that he may wish to open or save to. The client can still catch
the directory change by installing a function via the
FILE_LIST_CHANGE_DIR_FUNC
attribute.
See Also: 7.10.5
PANEL_NOTIFY_STATUS
If the panel item is part of an unpinned command frame, then the window is dismissed if PANEL_
NOTIFY_STATUS
is XV_OK. If PANEL_NOTIFY_STATUS is set to XV_ERROR, then the window is not
dismissed. You only xv_get() or xv_set() this attribute from within a notify procedure. When a
notify procedure exits, for an unpinned command frame, XView internally uses the value of this attri-
bute to determine whether or not the command frame is dismissed. XView sets the value of this attri-
bute to
XV_OK before calling the notify procedure. For the PATH_NAME package, see the following
PANEL_NOTIFY_STATUS explanation.
Argument: int
Valid Values: {
XV_OK, XV_ERROR}
Default: XV_OK
Procs: get, set
Objects: Panel_item
See Also: 7.9.1
120 XView Reference Manual

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

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