
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, ...