popup_list
A DCL popup_list component represents a dropdown menu.
A popup_list is a child tile.
related attributes
- These attributes are predefined for a list_box or popup_list
only:
-
- list
- With this attribute, the initial
contents of the popup_list can be specified. To separate between
rows, use the newline symbol "\n". To separate between columns use
the tab symbol "\t". To change the contents of the popup_list at
runtime, use the functions start_list, add_list, end_list.
- tabs
- This attribute can be used to control
the width of columns. The value of this attribute has to be a
string containing a space separated list of integers. For historic
reasons these integers are cumulative, it is a list of increasing
integers. Every integer adds the width of the next column to the
previous cumulative width. So to specify four columns of width 5,
use "5 10 15 20". Mind that there will be a fifth column of
remaining width, so perhaps the last integer is not wanted.
- tab_truncate
- Normally text that is too wide to fit
in a column, will be spread across multiple columns and push
further any text that appears further in the same row. If this
attribute is set to true, text will be restricted to its own column
only. Truncated text cannot be revealed.
- This attribute is predefined only for an edit_box or
popup_list:
-
- edit_width
- This is an integer attribute that
specifies the width of the popup_list, excluding the width of the
optional label, excluding any additional width the popup_list might
receive during layouting.
- This attribute is predefined only for a text, text_part,
edit_box, list_box or popup_list:
-
- These attributes are predefined for every child tile and
consequently for a popup_list as well:
-
- These attributes are predefined for every tile and consequently
for a popup_list as well:
-
- key
- value
- The value of a popup_list represents
its current selection. The value will be the index of the currently
selected row or an empty string if no row is selected.
- tooltip
- label
- Use the label attribute of a
popup_list to display a label above the dropdown control.
- fixed_height
- fixed_width
- alignment
- width
- bcad_width
- height
- bcad_height
- is_enabled
callbacks
When the selection of a popup_list is
changed - that is, when the list of choices disappears by choosing
a value - a callback with reason CBR_SELECT will be
triggered.
© Bricsys NV. All rights reserved. |