Volume 7A: XView Programming Manual

Figure 7-13. Sample panel with scrolling list

7.11.1 Displaying List Items

You can use either text strings or server images to display the choice to the user; you can

even intermix them. You specify the choices either one at a time or in a group. To set only

one choice, use PANEL_LIST_STRING or PANEL_LIST_GLYPH. When creating a new string

or glyph entry, if the index into the list specified is larger than the total number of entries,

then the new item is added to the end of the list. Use

PANEL_LIST_STRINGS or

PANEL_LIST_GLYPHS to set all the choices in a group. If no items exist in the list, the appro-

priate number of rows are created to fit all of the items. If the list already contains items,

then the first n rows of items are replaced by the newly specified strings or glyphs (where n is

the number of strings or glyphs specified).

The width of the list item can be set to explicit pixel values using

PANEL_LIST_WIDTH. The

minimum value for this attribute is 25. This reserves enough space for the list’s borders and

margins. Setting PANEL_LIST_WIDTH to -1 extends the width of the scrolling list box to the

edge of the panel. Setting PANEL_LIST_WIDTH to 0 sets the width to that of the widest row

in the scrolling list. Alternatively, the number of rows that are displayed in the list item can

be controlled through the value of the PANEL_LIST_DISPLAY_ROWS attribute. This value

governs the height, in rows, ...