tsc_DropDownXCodeListField

The tsc_DropDownXCodeListField allows a list of translated string items to be displayed on a form.  Initially only the selected item is displayed, and a drop-down arrow allows the user to display a full list.  The list will open as far as the bottom of the form, and if more items exist in the list a scrollbar is added.

Where the strings in a list are not translated, use the tsc_DropDownStringListField.

If the strings that are to be displayed represent an enum, use the tsc_DropDownEnumListField.

Control sizing

Drop-down lists may contain any reasonable number of items. 

The control in its closed-up state occupies a single line on a form and if no string within the list is too long, then two may fit side by side.  The width of the control is determined by the longest string. 

Horizontally, the list is sized to the longest string item, up to the width of the form.  When using a custom layout, the SetCustomDimensions() method on the control may be used to set the list to a fixed width.

When the list is opened by the user, it may occupy as much vertical space as is available on the form.  If the list contains more items than will fit, a vertical scroll bar is added.

The image to the right shows a variety of drop-down lists as displayed by the drop-down form in the HowTo sample.  See the Samples subdirectory in the SDK distribution.

Public methods