Volume 7B: XView Reference Manual

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

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

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

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

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