![](/api/v2/epubs/9780937175880/files/bg91.png)
PANEL_LIST_GLYPH
Takes a row number (argument 1) and Server_image (argument 2) to let you assign a glyph or icon
to a row. The height of the glyph may not exceed the height of the scrolling list row. Also see
PANEL_LIST_ROW_HEIGHT.
Return Type: Server_image
Argument 1: int
Argument 2: Server_image
Default:
NULL
Procs: create, get, set
Objects: Panel_list_item
See Also: 7.11.1
PANEL_LIST_GLYPHS
Works the same as its companion attribute, PANEL_LIST_GLYPH, except that it takes a NULL-
terminated value list as its value. The height of the glyph may not exceed the height of the scrolling
list row. Also see
PANEL_LIST_ROW_HEIGHT.
Argument:
NULL-terminated list of Server_image
Default:
NULL
Procs: create, set
Objects: Panel_list_item
See Also: 7.11.1
PANEL_LIST_INACTIVE
Grays out a row in a
PANEL_LIST. Note that a row that is inactive cannot be selected at the same
time. Also, mouseless navigation is not effected by the inactive state of the individual rows.
Argument 1: int
Argument 2: Bool
Default:
FALSE
Procs: create, get, set
Objects: Panel_list_item
See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.
PANEL_LIST_INSERT
Inserts a list item at a specified row number. This attribute allocates space, attaches a row number to
the list, and inserts an empty string. Clients must set
PANEL_LIST_GLYPH and/or
PANEL_LIST_STRING
at this row number to set the glyph item and/or string.
Argument: int
Procs: create, set
Objects: Panel_list_item
See Also: 7.11.2
PANEL_LIST_INSERT_DUPLICATE
Allow (
TRUE) or disallow (FALSE ) duplicate strings to be inserted into the scrolling list.
Argument: Bool
Default:
TRUE
Procs: create,get,set
Objects: Panel_list_item
See Also: 7.11.2
XView Attributes
XView Attributes 111
![](/api/v2/epubs/9780937175880/files/bg60.png)
PANEL_LIST_INSERT_GLYPHS
Insert the specified glyphs into the scrolling list before the specified row. The first argument is a row
number, and the second argument is a pointer to a NULL-terminated array of server images.
Argument 1: int
Argument 2:
NULL-terminated list of Server_image
Procs: create,set
Objects: Panel_list_item
See Also: 7.11.2
PANEL_LIST_INSERT_STRINGS
Insert the specified strings into the scrolling list before the specified row. The first argument is a row
number, and the second argument is a pointer to a NULL-terminated array of strings. The strings are
copied when this attribute is set.
Argument 1: int
Argument 2:
NULL-terminated list of char *
Procs: create,set
Objects: Panel_list_item
See Also: 7.11.2
PANEL_LIST_MASK_GLYPH
Tells the
PANEL_LIST to use the given Server_image as a clip mask for the corresponding
PANEL_LIST_GLYPH. The Server_image supplied must be of depth 1.
Argument: int
Argument: Server_image
Default:
XV_NULL
Procs: create, get, set
Objects: Panel_list
See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.
PANEL_LIST_MASK_GLYPHS
Like PANEL_LIST_MASK_GLYPH, but takes a NULL terminated list of glyphs rather than a row and a
single handle.
Argument:
NULL-terminated list of Server_image
Procs: create, set
Objects: Panel_list
See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.
PANEL_LIST_MODE
Sets or gets the mode of the scrolling list. Setting the mode to
PANEL_LIST_READ , when in edit
mode is equivalent to selecting the “End Editing” menu item. Setting the mode to
PANEL_LIST_EDIT when in read mode is equivalent to selecting the “Edit List” menu item.
Argument: Panel_list_mode
Valid Values: {
PANEL_LIST_READ, PANEL_LIST_EDIT}
Default:
PANEL_LIST_READ
Procs: get,set
Objects: Panel_list_item
See Also: 7.11.5
112 XView Reference Manual
![](/api/v2/epubs/9780937175880/files/bg91.png)
PANEL_LIST_NEXT_SELECTED
Returns the row number of the first selected row following the row specified. If no row after the row
specified is selected, returns -1.
Argument: int
Procs: get
Objects: Panel_list_item
See Also: 7.11.3
PANEL_LIST_NROWS
Gets the total number of rows in the scrolling list.
Return Type: int
Procs: get
Objects: Panel_list_item
PANEL_LIST_ROW_HEIGHT
Specifies the height of each row in the scrolling list.
Argument: int
Default: Height of panel’s font
Procs: create, get
Objects: Panel_list_item
See Also: 7.11.1
PANEL_LIST_ROW_VALUES
Improved performance method of getting/setting row values into the
PANEL_LIST. Takes the row
number, a pointer to a Panel_list_row_values array, and a count of how many rows in the ar-
ray. Panel_list_row_values defined shown below.
Argument 1: int
Argument 2: struct *
Argument 3: int
Procs: create, get, set
Objects: Panel_list
typedef struct {
char * string;
Server_image glyph;
Server_image mask_glyph;
Xv_font font;
Xv_opaque client_data;
Xv_opaque extension_data;
unsigned inactive : 1;
unsigned selected : 1;
} Panel_list_row_values;
On xv_get, the arguments remain the same, the struct passed in gets filled in by the
PANEL_LIST package. The return value is the number of rows that were successfully
filled in.
XView Attributes
XView Attributes 113
![](/api/v2/epubs/9780937175880/files/bg60.png)
PANEL_LIST_SCROLLBAR
Returns the scrollbar attached to a PANEL_LIST panel item.
Return Type: Scrollbar
Procs: get
Objects: Panel_list_item
PANEL_LIST_SELECT
Takes two values: a row number (argument 1) and a Bool (argument 2) that lets you select (TRUE) or
deselect (FALSE) the specified row. If the scrolling list is not hidden (XV_SHOW is TRUE) then the
specified row will be made visible, which may entail scrolling the scrolling list. To disable this scrol-
ling, set XV_SHOW to FALSE before setting PANEL_LIST_SELECT and then reset XV_SHOW to TRUE af-
terwards.
Argument 1: int
Argument 2: Bool
Default:
FALSE
Procs: set, create
Objects: Panel_list_item
See Also: 7.11.3
PANEL_LIST_SELECTED
Returns whether the specified row number is selected (TRUE) or not (FALSE).
Argument: int
Return Type: Bool
Procs: get
Objects: Panel_list_item
PANEL_LIST_SORT
Sort the list in forward (PANEL_FORWARD) or reverse (PANEL_REVERSE) alphabetical order. The
FILE_LIST
package consumes this attribute. Use FILE_LIST_COMPARE_FUNC in its place.
Argument: Panel_setting
Valid values:
PANEL_FORWARD or PANEL_REVERSE
Procs: set
Objects: Panel_list_item
PANEL_LIST_STRING
Specifies the string (argument 2) of a specified row (argument 1). xv_get returns the pointer to the
character string assigned to the row. The string is copied when this attribute is set.
Return Type: char *
Argument 1: int (row number)
Argument 2: char *
Default: Empty string
Procs: create, get, set
Objects: Panel_list_item
See Also: 7.11.1
114 XView Reference Manual
![](/api/v2/epubs/9780937175880/files/bg91.png)
PANEL_LIST_STRINGS
Works the same as its companion attribute, PANEL_LIST_STRING, except that it takes a NULL-
terminated list of strings as its value. The strings are copied when this attribute is set.
Argument:
NULL-terminated list of char *
Default: Empty string
Procs: create, set
Objects: Panel_list_item
See Also: 7.11.1
PANEL_LIST_TITLE
The title of the scrolling list. PANEL_LIST_TITLE makes a copy of the string. When the scrolling list
is removed, the package will free the title string.
Argument: char *
Default: No title
Procs: create,get,set
Objects: Panel_list_item
See Also: 7.11.1
PANEL_LIST_WIDTH
Specifies the width of the scrolling list: -1 extends the scrolling list to the right edge of the panel. A
value of 0 sets the width slightly wider than the widest row, and other values specify the width of the
scrolling list in pixels. To get the width of a
PANEL_LIST item’s rectangle, use XV_WIDTH. To get the
width of the label rectangle, use PANEL_LABEL_WIDTH.
Argument: int
Default: 0
Procs: create,get,set
Objects: Panel_list_item
See Also: 7.11.1
PANEL_MASK_CHAR
Specifies the character used to mask type-in characters. Use the space character for no character echo
(caret does not advance). Use the
NULL character to disable masking.
Argument: char
Default:
NULL
Procs: create,set,get
Objects: Panel_text_item, Panel_numeric_text_item
See Also: 7.15
PANEL_MAX_TICK_STRING
String which appears underneath the maximum tick mark on horizontal sliders or gauges, or to the
right of the maximum tick mark on vertical sliders or gauges. If
PANEL_TICKS is 0,
PANEL_MAX_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 maximum tick string
Procs: create,get,set
Objects: Panel_slider_item, Panel_gauge_item
See Also: 7.13
XView Attributes
XView Attributes 115
Get Volume 7B: XView Reference Manual now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.