Gets or sets a value that determines the look and feel of the check boxes. Gets or sets whether one or two mouse clicks are required to toggle the check state of an unfocused (unselected) item. Gets or sets whether single or multiple items can be checked simultaneously. Gets or sets the name of the data source field that provides check states for listbox items. Returns the number of checked items in the BaseCheckedListBoxControl.Items collection. Gets the collection of checked item values.īaseCheckedListBoxControl.CheckedItemsCount Gets the collection of indexes corresponding to checked items. Gets or sets whether check items in the checked list box should support three check states rather than two. The table below shows members related to the item checking functionality. If you want to perform both actions on one click, set the CheckedListBoxControl.CheckOnClick property to true.
The first click selects this item, and the second click toggles its check state. Item hot-tracking is not supported in multi-selection modes.Ī user needs to click an item twice to change its check state. The BaseListBoxControl.HotTrackSelectMode property allows you to specify whether an item is immediately selected once it is hot-tracked, or not. The item hot-tracking feature is initially disabled, and can be enabled with the BaseListBoxControl.HotTrackItems property. See this topic to know how items can be selected by end-users in multi-selection modes. Multiple item selection can be enabled with the BaseListBoxControl.SelectionMode property. When one or more items are selected, you can toggle the check states of all selected items at once by pressing the SPACE key or clicking a check box of any selected item.Īn end-user can select an item using the keyboard navigation keys, by clicking an item with the mouse, and optionally by hovering (hot-tracking) the item. The following image demonstrates a CheckedListBoxControl, in which the ‘Beijing’ item is checked, and the two items (‘Seoul’ and ‘Hong Kong’) are selected. Item selection is the capability to select (visually highlight) an item (or multiple items) and keep this highlighting after the mouse cursor leaves the control’s bounds. Once the mouse cursor leaves an item’s bounds, the item loses its hot-tracked state. Item hot-tracking (disabled by default) is highlighting an item on a mouse hover. Make note of the difference between an item’s checked, selected and hot-tracked states.Īn item’s checked state is visually indicated by the item’s check box. BaseCheckedListBoxControl.GetItemEnabled - Enables you to disable specific items, in bound mode.Ĭhecked States vs.BaseListBoxControl.ItemHeight - Gets or sets an item’s height.BaseListBoxControl.SelectedIndexChanged - Allows you to respond to item selection.BaseListBoxControl.ContextButtons - Provides access to the collection of context buttons displayed in the control.BaseListBoxControl.SelectionMode - Gets or sets whether a single or multiple items can be selected.BaseListBoxControl.MultiColumn - Gets or sets whether listbox items can be arranged across multiple columns.This property is not supported when listbox items are rendered based on Item Templates. BaseListBoxControl.DisplayMember - Gets or sets the name of the data source field that provides display text for listbox items.BaseListBoxControl.ValueMember - Gets or sets the field name in the bound data source whose contents are assigned to item values.
BaseListBoxControl.CustomItemTemplate - Allows you to provide a custom template for listbox items.BaseListBoxControl.CustomizeItem - Allows you to dynamically customize templated items.See Templated ListBox Items to learn more. BaseListBoxControl.Templates - This property supports the item templates feature.BaseListBoxControl.DataSource - Use this property to populate the control with items from a data source.BaseCheckedListBoxControl.Items - Allows you to populate the control with items in unbound mode.Instead, item check states are indicated with check marks.Īn end-user can switch between item check states by double-clicking or clicking an item with the mouse (see BaseCheckedListBoxControl.CheckOnClick) or by pressing the keyboard SPACE bar. There are no built-in check boxes when listbox items are rendered from a template. Each item can display multiple text and image elements arranged in any manner, and painted using different appearance settings. The Item Templates feature helps you render each listbox item as your needs dictate. The following members accept/return CheckedListBoxControl objects:īy default, the CheckedListBoxControl renders its items as text strings with built-in check boxes that reflect item check states.