PANEL_NOTIFY_STATUS
This attribute is overloaded by the Path Name package to represent whether or not the PANEL_
NOTIFY_PROC succeeded in validating the the last directory it was called with. The return value
from the notify procedure is of type Panel_setting and does not exactly match the same condi-
tion. Expected values are XV_OK or XV_ERROR in the case of an invalid path name. For a
PATH_ITEM, see the preceding PANEL_NOTIFY_STATUS explanation.
Argument: int
Default:
XV_OK
Procs: create, get, set
PANEL_NOTIFY_STRING
String of characters that triggers notification when one of the characters is typed in a text item. Ap-
plies only when PANEL_NOTIFY_LEVEL is PANEL_SPECIFIED. The string is copied when this attri-
bute is set.
Argument: char *
Default: \n \r \t (i.e., newline, carriage return, and tab)
Procs: create, get, set
Objects: Panel_numeric_text_item, Panel_text_item,
Panel_multiline_text_item
See Also: 7.15.3
PANEL_OPS_VECTOR
The panel operations vector, which is the method by which the panel package dispatches events to
panel items. For more information, see Section 25.11, “The Wizzy Package” in the XView Program-
ming Manual.
Argument: Panel_ops *
Procs: get,set
Objects: Panel_item
PANEL_PAINT
Controls the panel item’s painting behavior in xv_set calls. The specified value applies only to the
xv_set call. As the xv_set call exits, it restores
PANEL_PAINT to its previous value. Possible val-
ues are
PANEL_CLEAR, PANEL_NO_CLEAR, or PANEL_NONE. PANEL_PAINT operates on Panel and
Panel_item objects. The default for Panel item objects is the value of PANEL_PAINT for the Panel to
which the Panel item is attached. This attribute is used strictly for performance enhancements and,
normally, is not required.
Argument: Panel_setting
Default:
PANEL_CLEAR for panel objects, the panel’s PANEL_PAINT for panel item objects
Procs: create, set
Objects: Panel,Panel_item
See Also: 7.19.3
PANEL_PRIMARY_FOCUS_ITEM
The current or last panel item that is or was a primary (First-Class) focus client.
Warning: This attribute should only be used from within a panel item extension.
Argument: Panel_item
Procs: get,set
Objects: Panel
Usage:
if (xv_get(panel_public, PANEL_PRIMARY_FOCUS_ITEM) == item_public)
xv_set(panel_public, PANEL_PRIMARY_FOCUS_ITEM, NULL, NULL);
XView Attributes
XView Attributes 121
This example should be executed when an item’s remove procedure is called, if the item
is a primary focus client.
PANEL_READ_ONLY
If TRUE, editing is disabled; if FALSE, editing is enabled. Note that xv_set does not apply to scrol-
ling lists. PANEL_READ_ONLY mode defaults to TRUE for the FILE_LIST package as opposed to
FALSE for the PANEL_LIST package.
Argument: Bool
Default:
FALSE
TRUE
for a FILE_LIST.
Procs: create, get, set
Objects: Panel_list_item, Panel_multiline_text_item, Panel_numer-
ic_text_item, Panel_text_item, Panel_slider_item, File_list
PANEL_REPAINT_PROC
Specifies the name of the client-supplied panel background repaint procedure.
Argument: void (*panel_repaint_proc) ()
Default:
NULL
Procs: create, get, set
Objects: Panel
Callback:
void
panel_repaint_proc(panel, pw, repaint_area)
Panel panel;
Xv_Window pw; /* paint window */
Rectlist *repaint_area;
See Also: 7.19.2
PANEL_SHOW_RANGE
If
TRUE, shows the minimum and maximum slider or gauge values.
Argument: Bool
Default:
TRUE
Procs: create, get, set
Objects: Panel_slider_item, Panel_gauge_item
See Also: 7.13
PANEL_SHOW_VALUE
If TRUE
, shows current slider value.
Argument: Bool
Default:
TRUE
Procs: create, get, set
Objects: Panel_slider_item
See Also: 7.13
PANEL_SLIDER_END_BOXES
Shows or hides the slider end boxes.
Argument: Bool
Default:
FALSE
Procs: create,get,set
Objects: Panel_slider_item
See Also: 7.13
122 XView Reference Manual
PANEL_SLIDER_WIDTH
Specifies the length of the slider bar in pixels. The length is set whether the slider is horizontally or
vertically oriented.
Argument: int
Default: 100
Procs: create, get, set
Objects: Panel_slider_item
See Also: 7.13
PANEL_STATUS
Returns the state of the panel. See <xview/panel.h> for more information.
Warning: This attribute should only be used from within a panel item extension.
Argument: Panel_status *
Procs: get
Objects: Panel
PANEL_TEXT_SELECT_LINE
Selects and highlights the entire contents of the text field.
Argument: No value
Procs: set
Objects: Panel_text_item
Usage:
xv_set(ptext, PANEL_TEXT_SELECT_LINE, NULL);
See Also: 7.15.2
PANEL_TICKS
Specifies the number of evenly-spaced tick marks to be displayed on slider or gauge panel items.
Argument: int
Default: 0
Procs: create, get, set
Objects: Panel_slider_item, Panel_gauge_item
See Also: 7.13
PANEL_TOGGLE_VALUE
Specifies the value (argument 2) of a particular toggle choice (argument 1).
Argument 1: int
Argument 2: int
Default:
NULL
Procs: create, get, set
Objects: Panel_choice_item
PANEL_VALUE
Indicates the current value of a panel item. Its type varies depending on the type of panel item speci-
fied. See Chapter 7, Panels, in the Xview Programming Manual for details.
Argument: Varies with panel item type
Procs: create, get, set
Objects: Panel_item
See Also: 7.6
XView Attributes
XView Attributes 123
PANEL_VALUE_DISPLAY_LENGTH
Maximum number of characters to display in a text string. Note that the length of the value display
may not be less than the combined width of the left and right “more text” buttons. In 12-point font,
this is four characters. This attribute is intended for use with fixed-width fonts. For variable-width
fonts, use the attribute PANEL_VALUE_DISPLAY_WIDTH. For a Multiline Text Item, this specified the
length of each row (line) in the Multiline Text Field, expressed in characters.
Argument: int
Default: 80 (for Slider, Text, and Numeric Text Items)
40 (for a Multiline Text Item)
Procs: create,get,set
Objects: Panel_slider_item , Panel_numeric_text_item, Panel_text_item,
Panel_multiline_text_item
See Also: 7.17, 7.15
PANEL_VALUE_DISPLAY_WIDTH
The width, in pixels, of a text field’s value. For a Multiline Text Item, this is the width of each row
(line) in the Multiline Text Field.
Argument: int
Default: 80 default character widths (for Text and Numeric Text Items).
Width corresponding to value of
PANEL_VALUE_DISPLAY_LENGTH (for a Multiline Text
Item)
Procs: create,get,set
Objects: Panel_text_item, Panel_numeric_text_item,
Panel_multiline_text_item
See Also: 7.17, 7.15
PANEL_VALUE_FONT
Specifies the font to use in the value portion of the Panel Item.
Warning: Use of this attribute may cause your application to violate the OPENLOOK Graphical User
Interface Functional Specification.
Argument: Xv_Font
Default: Panel’s font
Procs: create,get,set
Objects: Panel_numeric_text_item, Panel_slider_item, Panel_text_item
PANEL_VALUE_STORED_LENGTH
Maximum number of characters allowed in string value for a text item. For Multiline Text Items, if
PANEL_VALUE_STORED_LENGTH
is greater than PANEL_VALUE_DISPLAY_LENGTH times
PANEL_DISPLAY_ROWS
, then a scrollbar will be visible on the Multiline Text Field. (An outstanding
bug in
TEXTSW_MEMORY_MAXIMUM
prevents PANEL_VALUE_STORED_LENGTH from being set to less
than 1024; thus a Multiline Text Item will always have a scrollbar.)
Argument: int
Default: Same as
TEXTSW_MEMORY_MAXIMUM default (for Multiline Text Item)
80 (for a Text or Numeric Text Item )
Procs: create,get,set
Objects: Panel_numeric_text_item, Panel_text_item,
Panel_multiline_text_item, Panel_list_item, Panel
See Also: 7.17, 7.15
124 XView Reference Manual
PANEL_VALUE_UNDERLINED
Show or hide the text field value’s underlining.
Argument: Bool
Default:
TRUE
Procs: create, get, set
Objects: Panel_text_item, Panel_numeric_text_item
PANEL_VALUE_X
Specifies the x coordinate of the value portion of panel items that have separate label and value enti-
ties (e.g., text items).
Argument: int
Default: (See Chapter 7, Panels, in the XView Programming Manual.)
Procs: create, get, set
Objects: Panel_item
See Also: 7.4.3,
PANEL_LABEL_X
PANEL_VALUE_Y
Specifies the y coordinate of the value portion of panel items that have separate label and value enti-
ties (e.g., Text Items).
Argument: int
Default: (See Chapter 7, Panels, in the XView Programming Manual.)
Procs: create, get, set
Objects: Panel_item
See Also: 7.4.3,
PANEL_LABEL_Y
PATH_IS_DIRECTORY
Specifies if the PATH_NAME package should accept a path name as a directory or a full path to a file
name. Changing this value from
FALSE to TRUE has the side effect of setting the PATH_LAST_
VALIDATED value to NULL if it is not a directory.
Argument: Bool
Default:
FALSE
Procs: create, get, set
Objects: Path_name
See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.
PATH_LAST_VALIDATED
PANEL_VALUE
returns the current contents of the Textfield, PATH_LAST_VALIDATED returns the last
path name to pass validation in the Textfield. This means that you are always guaranteed of receiving
a valid path name with this attribute. Note that this is always the expanded version of the path name,
whereas
PANEL_VALUE
will return the current contents of the field.
Warning: if no path name has passed validation, this will return a
NULL. Also, setting PATH_IS_
DIRECTORY will cause this value to become NULL.
Argument: char *
Default:
NULL
Procs: get
Objects: Path_name
See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.
XView Attributes
XView Attributes 125

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.