Comboboxes
Comboboxes are represented using the BarComboBoxCommand and a BarComboBoxLink classes. The BarComboBoxCommand class is the base command for the BarComboBoxLink, which is the command link.
See the Commands and Command Links topic for more information on commands and command links and how they relate to each other.
Comboboxes have two modes of input, normal and drop-down list. The style is specified by the Style property on the command and takes an enumeration value of type BarComboBoxCommandStyle.
When using the normal style, a drop-down of items can be displayed and typing can occur in the combobox. The selecting of a drop-down item, pressing of Enter or the changing of a value and tabbing off the combobox will raise the command click event.
When using the drop-down list style, a drop-down of items can be displayed and but the text in the combobox is read-only. The selecting of a drop-down item will raise the command click event.
Obtaining the Combobox Value
The combobox value can be retrieved from the command's ControlValue property. This value will be displayed in all command link instances of the command.
Setting the Width and Drop-Down Width
The width of the combobox can be set using the command's Width property. The width of the combobox's drop-down can be set using the command's DropDownWidth property.
Adding Items to the Combobox Drop-Down
Items can be added to all command link instances of the combobox by adding them to the Items collection.
Setting the Selected Index
The selected index of the combobox can be set using the command's SelectedIndex property. The value must be set to a valid index in the command's Items collection.
Enabling / Disabling
Command links can be enabled or disabled based on a resolved value of enabled properties, one on the command and one on the command link that can override it. The command link's Enabled accepts a DefaultableBoolean, which can override the command's Enabled property.
Keyboard Shortcuts
Keyboard shortcuts can be set to the command by adding the appropriate BarKeyboardShortcut instances to the KeyboardShortcuts collection on the command.
See the Keyboard Shortcuts topic for more information on keyboard shortcuts.
Begin a Group
The BeginAGroup property on each command link indicates whether the command link begins a group. If it does, a separator will be drawn before it.
Visibility
The Visible property on each command link controls whether the command link is visible or invisible within its parent bar control.
Tooltips
Tooltips will be displayed for the command if the ToolTipEnabled property is set to true. The tooltip will display the value of the Text property unless the ToolTipText property overrides it with a different value. The ToolTipText property can be left as null to indicate to use the Text property instead.
Changing the Text Displayed in the Run-Time Customize Dialog for the Command
By default, the Text property value of the command will be displayed in the run-time customize dialog's command listbox. However if this is not appropriate or needs to be customized for the command listbox, the CustomizeListText property can be set to override what is displayed.