WinForms › Checked Image List Combobox › MultiSelectableCheckedImageListCombobox

MultiSelectableCheckedImageListCombobox

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.Containers

A combo box whose drop-down is a checked list of rich items – a title, a line of text and an image on each – so the user can pick several, and the closed box lists the ones picked.

public partial class MultiSelectableCheckedImageListCombobox : BinaryTextComboBox

Inherits from / implements: BinaryTextComboBox

Remarks

Items

The items, and the look of the drop-down list, belong to MultiSelectableCheckedImageListBoxConfiguration: add CheckedImageListBoxItem objects to its CheckedImageListBoxConfiguration.Items. They are copied into the drop-down each time it opens, so a change shows from the next open. A check the user makes is kept on the item itself.

What the box shows

The text area is read-only. It lists the checked items – each one's DisplayMember property if you name one, otherwise its title, otherwise its content text – separated by CheckedItemTextDisplaySeparationDelimiterChars. It is rebuilt when the user checks or unchecks an item and when ToggleCheckStateForAllItems is set.

The drop-down

It opens below the box at DropdownSize, with a band underneath that the user can drag to make it taller or wider. Clicking an item toggles its check box; the drop-down stays open until the user clicks elsewhere.

Reading the choice

Handle ItemCheckStateChanged, or read CheckedItems or CheckedIndices. Both are read from the drop-down list, so they are empty until the drop-down has opened once (or ToggleCheckStateForAllItems has been set); before that, read each item's CheckedImageListBoxItem.IsChecked.

Examples

Pizza toppings, chosen together and shown in the box as "Mushrooms + Olives".

var toppings = new MultiSelectableCheckedImageListCombobox
{
    Width = 320,
    DropdownSize = new Size(320, 260),
    CheckedItemTextDisplaySeparationDelimiterChars = "+"
};

CheckedImageListBoxConfiguration list = toppings.MultiSelectableCheckedImageListBoxConfiguration;
list.Items.Add(new CheckedImageListBoxItem { Title = "Mushrooms", ContentText = "Chestnut, sliced" });
list.Items.Add(new CheckedImageListBoxItem { Title = "Olives", ContentText = "Kalamata, pitted" });
list.Items.Add(new CheckedImageListBoxItem { Title = "Peppers", ContentText = "Roasted red" });

toppings.ItemCheckStateChanged += (sender, e) =>
    orderSummary.Text = toppings.CheckedItems.Count + " toppings";

Controls.Add(toppings);

Members at a glance

Constructors
`MultiSelectableCheckedImageListCombobox`	Creates the control with no items, a drop-down of 500 by 400 logical pixels and a read-only text area.
Properties
`AnimateDropDownWindow`	Hidden. This control inherits animate drop down window from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AnimationInterval`	Hidden. This control inherits animation interval from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoComplete`	Hidden. This control inherits auto complete from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteBasedOnCompleteMatchWithAnItemInTheList`	Hidden. This control inherits auto complete based on complete match with an item in the list from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteCustomSource`	Hidden. This control inherits auto complete custom source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteIsCaseSensitive`	Hidden. This control inherits auto complete is case sensitive from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteMode`	Hidden. This control inherits auto complete mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteSource`	Hidden. This control inherits auto complete source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`AutoCompleteStyleForMultiColumnModeIsMultiColumn`	Hidden. This control inherits auto complete style for multi column mode is multi column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`BuiltinFilterOnNonStringTypeColumnFilterMode`	Hidden. This control inherits builtin filter on non string type column filter mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`BuiltinFilterOnStringTypeColumnFilterMode`	Hidden. This control inherits builtin filter on string type column filter mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`BusyIndicatorText`	Hidden. This control inherits busy indicator text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`CSVFileSaveAs`	Hidden. This control inherits CSV file save as from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`CheckedIndices`	Gets the positions of the checked items in the drop-down list.
`CheckedItemTextDisplaySeparationDelimiterChars`	Gets or sets the text put between the checked items in the box.
`CheckedItems`	Gets the checked items.
`ColumnDataTypeFormatInfoContainers`	Hidden. This control inherits column data type format info containers from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ColumnWidths`	Hidden. This control inherits column widths from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ColumnsToDisplay`	Hidden. This control inherits columns to display from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`CustomColumnNameForAutomaticRowSelection`	Hidden. This control inherits custom column name for automatic row selection from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`CustomComparerImplementor`	Hidden. This control inherits custom comparer implementor from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`CustomDropDownWindowLocationPoint`	Hidden. This control inherits custom drop down window location point from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DataMember`	Hidden. This control inherits data member from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DataSource`	Hidden. This control inherits data source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DataSourceViewCustomSortingExpression`	Hidden. This control inherits data source view custom sorting expression from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DesiredFilterColumn`	Hidden. This control inherits desired filter column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DisplayLocation`	Gets the point, in the box's client coordinates, where the drop-down last opened.
`DisplayMember`	Gets or sets the name of a property of the items whose value the box shows for each checked item.
`DrawMode`	Hidden. This control inherits draw mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownHeight`	Hidden. This control inherits drop down height from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownItemBorderColor`	Hidden. This control inherits drop down item border color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownItemTextAlignment`	Hidden. This control inherits drop down item text alignment from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownStyle`	Hidden. This control inherits drop down style from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownWidth`	Hidden. This control inherits drop down width from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropDownWindowDisplayOrientation`	Hidden. This control inherits drop down window display orientation from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropStyleIsMultiColumn`	Hidden. This control inherits drop style is multi column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`DropdownContentMargin`	Not used.
`DropdownContentPadding`	Gets or sets the space between the edge of the drop-down and the list inside it.
`DropdownResizeGripperColor`	Gets or sets the colour of the triangle of lines in the band under the drop-down list.
`DropdownResizeSectionBorderColor`	Gets or sets the colour of the line round the band under the drop-down list.
`DropdownResizeSectionFillColor`	Gets or sets the background of the band under the drop-down list.
`DropdownSize`	Gets or sets the size of the drop-down list when it opens.
`EnableAlphaBlendingForFilterAndGroupingPanelBackColor`	Hidden. This control inherits enable alpha blending for filter and grouping panel back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`EnableColumnSorting`	Hidden. This control inherits enable column sorting from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`EnableDrawingHeaderFooterWhenInMultiColumnMode`	Hidden. This control inherits enable drawing header footer when in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`EnableUserColumnResizing`	Hidden. This control inherits enable user column resizing from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`EnforceItemsInList`	Hidden. This control inherits enforce items in list from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`FilterAndGroupingPanelBackColor`	Hidden. This control inherits filter and grouping panel back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`FilteringIsON`	Hidden. This control inherits filtering is ON from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`FormatString`	Hidden. This control inherits format string from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`FormattingEnabled`	Hidden. This control inherits formatting enabled from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`GroupItemsWhenInMultiColumnDisplayMode`	Hidden. This control inherits group items when in multi column display mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`GroupMultiColumnDisplayModeDataBasedOnThisColumn`	Hidden. This control inherits group multi column display mode data based on this column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`HeadersToDisplay`	Hidden. This control inherits headers to display from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`IsAutoCompleteModeAppendSuggestInMultiColumnMode`	Hidden. This control inherits is auto complete mode append suggest in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`IsCustomisationOfColumnDisplayEnabledInMultiColumnAutoSuggestMode`	Hidden. This control inherits is customisation of column display enabled in multi column auto suggest mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`IsDropdownInvocationBlocked`	Gets or sets whether clicking the box, and Alt+Down, are stopped from opening the drop-down.
`IsFilterSearchResultBasedOnColumnDataType`	Hidden. This control inherits is filter search result based on column data type from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`IsTextSelectedUponGainingFocus`	Gets or sets whether the box's text is left selected when the box gains the focus.
`ItemSelectionClick`	Hidden. This control inherits item selection click from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`KeepBindingContextInSyncWithParent`	Hidden. This control inherits keep binding context in sync with parent from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`KeepTheFilterAndGroupingViewsCollapsedAtStartUp`	Hidden. This control inherits keep the filter and grouping views collapsed at start up from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`KeepTheFilterAndGroupingViewsPaneFullyCollapsedAtStartup`	Hidden. This control inherits keep the filter and grouping views pane fully collapsed at startup from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropDownSize`	Hidden. This control inherits multi column drop down size from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropDownWindowBorderThickness`	Hidden. This control inherits multi column drop down window border thickness from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropDownWindowConfigurationData`	Hidden. This control inherits multi column drop down window configuration data from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListBackColor`	Hidden. This control inherits multi column drop list back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListFont`	Hidden. This control inherits multi column drop list font from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListForeColor`	Hidden. This control inherits multi column drop list fore color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListGridLines`	Hidden. This control inherits multi column drop list grid lines from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListHoverSelection`	Hidden. This control inherits multi column drop list hover selection from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDropListWindowIsResizable`	Hidden. This control inherits multi column drop list window is resizable from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnDroplistWindowAnimationStyle`	Hidden. This control inherits multi column droplist window animation style from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnViewBusyProcessingText`	Hidden. This control inherits multi column view busy processing text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnViewNoDataFoundText`	Hidden. This control inherits multi column view no data found text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnViewSortingGlyphColor`	Hidden. This control inherits multi column view sorting glyph color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnViewUIElementsTextProvider`	Hidden. This control inherits multi column view UI elements text provider from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiColumnWindowColumnsHorizontalAlignments`	Hidden. This control inherits multi column window columns horizontal alignments from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`MultiSelectableCheckedImageListBoxConfiguration`	Gets or sets the items of the drop-down list and its look.
`RaiseNotInListWhenTyping`	Hidden. This control inherits raise not in list when typing from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShareCustomMultiColumnSizeAcrossDataListAndFilterGroupingOptionsPane`	Hidden. This control inherits share custom multi column size across data list and filter grouping options pane from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShouldAllowDragDropOfColumns`	Hidden. This control inherits should allow drag drop of columns from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShouldAllowUserInputWhileProcessingMultiColumnAutoCompleDropDownView`	Hidden. This control inherits should allow user input while processing multi column auto comple drop down view from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShouldApplyMultiColumnWindowColumnsAlignmentsToAutoCompleteDropDown`	Hidden. This control inherits should apply multi column window columns alignments to auto complete drop down from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShouldDisplayColumnHeadersWhenInMultiColumnMode`	Hidden. This control inherits should display column headers when in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShouldDrawBidirectionalResizeGripper`	Gets or sets whether the standard size grip is drawn in the corner of the band under the drop-down list.
`ShouldDrawDropdownResizeSectionWith3DBorder`	Gets or sets whether the band under the drop-down list has a raised 3-D edge instead of a line in `DropdownResizeSectionBorderColor`.
`ShouldDrawVerticalResizeGripper`	Gets or sets whether a small triangle of lines is drawn in the middle of the band under the drop-down list, to show it can be dragged.
`ShouldPersistUserSetColumnWidthsAcrossFilterSessions`	Hidden. This control inherits should persist user set column widths across filter sessions from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShowDropDownMultiColumnWindowAfterAdjustingForVirtualAvaliableScreenSpace`	Hidden. This control inherits show drop down multi column window after adjusting for virtual avaliable screen space from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShowEmptyDropListViewWhenThereAreNoData`	Hidden. This control inherits show empty drop list view when there are no data from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ShowFilterOptionsInMultiColumnMode`	Hidden. This control inherits show filter options in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`SizeForMultiColumnAutoCompleteSuggestionDropDownWindow`	Hidden. This control inherits size for multi column auto complete suggestion drop down window from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`SizesForMultiColumnAutoCompleteSuggestionDropDownWindowColumns`	Hidden. This control inherits sizes for multi column auto complete suggestion drop down window columns from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`Sorted`	Hidden. This control inherits sorted from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`TableToLoad`	Hidden. This control inherits table to load from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
`ToggleCheckStateForAllItems`	Gets or sets the check state of every item at once: `true` checks them all, `false` clears them all.
`ValueMember`	Hidden. This control inherits value member from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.
Methods
`OnAllItemsCheckedOrUncheckedChanged`	Rebuilds the box's text and raises `AllItemsCheckedOrUncheckedChanged`.
`OnDropDown`	Opens the checked list below the box, in place of the standard list: copies the configuration and the items to it and shows it at `DropdownSize`.
`OnGotFocus`	Raises `Control.GotFocus`, hides the insertion point and, unless `IsTextSelectedUponGainingFocus` is on, clears the selection.
`OnHandleCreated`	Raises `Control.HandleCreated`, clears the text and makes the text area read-only.
`OnItemCheckStateChanged`	Rebuilds the box's text after the user checks or unchecks an item. `ItemCheckStateChanged` is raised after this method returns.
`OnTextChanged`	Raises `Control.TextChanged` and hides the insertion point.
`OnTextUpdate`	Raises `ComboBox.TextUpdate` and hides the insertion point, since the text is not typed.
`PreProcessMessage`	Pre-processes keyboard messages, dropping Alt+Down while `IsDropdownInvocationBlocked` is on.
`SetItemCheckState`	Checks or unchecks one item from code.
`WndProc`	Processes the control's window messages, dropping mouse clicks while `IsDropdownInvocationBlocked` is on.
Events
`AllItemsCheckedOrUncheckedChanged`	Occurs when `ToggleCheckStateForAllItems` is set, after every item has been checked or cleared and the box's text rebuilt.
`ItemCheckStateChanged`	Occurs when the user checks or unchecks an item in the drop-down list, after the box's text has been rebuilt.

Constructors

MultiSelectableCheckedImageListCombobox

public MultiSelectableCheckedImageListCombobox()

Creates the control with no items, a drop-down of 500 by 400 logical pixels and a read-only text area.

Properties

AnimateDropDownWindow

public new object AnimateDropDownWindow

Hidden. This control inherits animate drop down window from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AnimationInterval

public new object AnimationInterval

Hidden. This control inherits animation interval from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoComplete

public new bool AutoComplete

Hidden. This control inherits auto complete from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteBasedOnCompleteMatchWithAnItemInTheList

public new bool AutoCompleteBasedOnCompleteMatchWithAnItemInTheList

Hidden. This control inherits auto complete based on complete match with an item in the list from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteCustomSource

public new object AutoCompleteCustomSource

Hidden. This control inherits auto complete custom source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteIsCaseSensitive

public new bool AutoCompleteIsCaseSensitive

Hidden. This control inherits auto complete is case sensitive from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteMode

public new object AutoCompleteMode

Hidden. This control inherits auto complete mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteSource

public new object AutoCompleteSource

Hidden. This control inherits auto complete source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

AutoCompleteStyleForMultiColumnModeIsMultiColumn

public new bool AutoCompleteStyleForMultiColumnModeIsMultiColumn

Hidden. This control inherits auto complete style for multi column mode is multi column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

BuiltinFilterOnNonStringTypeColumnFilterMode

public new object BuiltinFilterOnNonStringTypeColumnFilterMode

Hidden. This control inherits builtin filter on non string type column filter mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

BuiltinFilterOnStringTypeColumnFilterMode

public new object BuiltinFilterOnStringTypeColumnFilterMode

Hidden. This control inherits builtin filter on string type column filter mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

BusyIndicatorText

public new object BusyIndicatorText

Hidden. This control inherits busy indicator text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

CSVFileSaveAs

public new object CSVFileSaveAs

Hidden. This control inherits CSV file save as from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

CheckedIndices

public IList<int> CheckedIndices

Gets the positions of the checked items in the drop-down list.

Value: A new list each time, in item order. Changing it changes nothing.

Remarks

Read from the items in CheckedImageListBoxConfiguration.Items, so it is right whether or not the drop-down has opened.

CheckedItemTextDisplaySeparationDelimiterChars

public string CheckedItemTextDisplaySeparationDelimiterChars

Gets or sets the text put between the checked items in the box.

Value: The default is " --- ".

Remarks

Put between the items exactly as given, with nothing after the last item. Setting it rebuilds the box's text at once.

CheckedItems

public IList<CheckedImageListBoxItem> CheckedItems

Gets the checked items.

Value: A new list each time, in item order. Changing it changes nothing; check or uncheck an item through SetItemCheckState or its CheckedImageListBoxItem.IsChecked.

Remarks

Read from the items in CheckedImageListBoxConfiguration.Items, so it is right whether or not the drop-down has opened.

ColumnDataTypeFormatInfoContainers

public new object ColumnDataTypeFormatInfoContainers

Hidden. This control inherits column data type format info containers from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ColumnWidths

public new object ColumnWidths

Hidden. This control inherits column widths from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ColumnsToDisplay

public new object ColumnsToDisplay

Hidden. This control inherits columns to display from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

CustomColumnNameForAutomaticRowSelection

public new object CustomColumnNameForAutomaticRowSelection

Hidden. This control inherits custom column name for automatic row selection from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

CustomComparerImplementor

public new object CustomComparerImplementor

Hidden. This control inherits custom comparer implementor from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

CustomDropDownWindowLocationPoint

public new object CustomDropDownWindowLocationPoint

Hidden. This control inherits custom drop down window location point from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DataMember

public new object DataMember

Hidden. This control inherits data member from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DataSource

public new object DataSource

Hidden. This control inherits data source from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DataSourceViewCustomSortingExpression

public new object DataSourceViewCustomSortingExpression

Hidden. This control inherits data source view custom sorting expression from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DesiredFilterColumn

public new object DesiredFilterColumn

Hidden. This control inherits desired filter column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DisplayLocation

public Point DisplayLocation

Gets the point, in the box's client coordinates, where the drop-down last opened.

Value: The bottom-left corner of the box.

Remarks

It is set each time the drop-down opens, so a value assigned to it has no effect.

DisplayMember

public new string DisplayMember

Gets or sets the name of a property of the items whose value the box shows for each checked item.

Value: A property name, or null (the default) to show each item's title.

Remarks

The property is looked up on each item's own type, so it can be one you add in a class derived from CheckedImageListBoxItem. If the item has no such property, or its value is null, the title is shown; if the title is empty too, the content text.

DrawMode

public new object DrawMode

Hidden. This control inherits draw mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownHeight

public new int DropDownHeight

Hidden. This control inherits drop down height from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownItemBorderColor

public new object DropDownItemBorderColor

Hidden. This control inherits drop down item border color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownItemTextAlignment

public new object DropDownItemTextAlignment

Hidden. This control inherits drop down item text alignment from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownStyle

public new ComboBoxStyle DropDownStyle

Hidden. This control inherits drop down style from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownWidth

public new int DropDownWidth

Hidden. This control inherits drop down width from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropDownWindowDisplayOrientation

public new object DropDownWindowDisplayOrientation

Hidden. This control inherits drop down window display orientation from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropStyleIsMultiColumn

public new object DropStyleIsMultiColumn

Hidden. This control inherits drop style is multi column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

DropdownContentMargin

public Padding DropdownContentMargin

Not used.

Value: Kept for compatibility; any value is ignored. Use DropdownContentPadding.

DropdownContentPadding

public Padding DropdownContentPadding

Gets or sets the space between the edge of the drop-down and the list inside it.

Value: The default is no padding.

DropdownResizeGripperColor

public Color DropdownResizeGripperColor

Gets or sets the colour of the triangle of lines in the band under the drop-down list.

Value: The default is SystemColors.ControlDark. Color.Empty is transparent, so nothing is seen.

DropdownResizeSectionBorderColor

public Color DropdownResizeSectionBorderColor

Gets or sets the colour of the line round the band under the drop-down list.

Value: The default is SystemColors.ControlDark. Color.Empty is transparent, so nothing is seen.

Remarks

Not used while ShouldDrawDropdownResizeSectionWith3DBorder is on.

DropdownResizeSectionFillColor

public Color DropdownResizeSectionFillColor

Gets or sets the background of the band under the drop-down list.

Value: The default is Color.Empty, which is transparent, so the drop-down's own background shows.

DropdownSize

public Size DropdownSize

Gets or sets the size of the drop-down list when it opens.

Value: In logical pixels. The default is 500 by 400.

Remarks

The band the user drags to resize is added below it. A size the user drags to is not kept: the next open uses this size again.

EnableAlphaBlendingForFilterAndGroupingPanelBackColor

public new object EnableAlphaBlendingForFilterAndGroupingPanelBackColor

Hidden. This control inherits enable alpha blending for filter and grouping panel back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

EnableColumnSorting

public new object EnableColumnSorting

Hidden. This control inherits enable column sorting from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

EnableDrawingHeaderFooterWhenInMultiColumnMode

public new object EnableDrawingHeaderFooterWhenInMultiColumnMode

Hidden. This control inherits enable drawing header footer when in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

EnableUserColumnResizing

public new object EnableUserColumnResizing

Hidden. This control inherits enable user column resizing from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

EnforceItemsInList

public new object EnforceItemsInList

Hidden. This control inherits enforce items in list from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

FilterAndGroupingPanelBackColor

public new object FilterAndGroupingPanelBackColor

Hidden. This control inherits filter and grouping panel back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

FilteringIsON

public new object FilteringIsON

Hidden. This control inherits filtering is ON from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

FormatString

public new object FormatString

Hidden. This control inherits format string from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

FormattingEnabled

public new object FormattingEnabled

Hidden. This control inherits formatting enabled from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

GroupItemsWhenInMultiColumnDisplayMode

public new object GroupItemsWhenInMultiColumnDisplayMode

Hidden. This control inherits group items when in multi column display mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

GroupMultiColumnDisplayModeDataBasedOnThisColumn

public new object GroupMultiColumnDisplayModeDataBasedOnThisColumn

Hidden. This control inherits group multi column display mode data based on this column from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

HeadersToDisplay

public new object HeadersToDisplay

Hidden. This control inherits headers to display from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

IsAutoCompleteModeAppendSuggestInMultiColumnMode

public new object IsAutoCompleteModeAppendSuggestInMultiColumnMode

Hidden. This control inherits is auto complete mode append suggest in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

IsCustomisationOfColumnDisplayEnabledInMultiColumnAutoSuggestMode

public new object IsCustomisationOfColumnDisplayEnabledInMultiColumnAutoSuggestMode

Hidden. This control inherits is customisation of column display enabled in multi column auto suggest mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

IsDropdownInvocationBlocked

public bool IsDropdownInvocationBlocked

Gets or sets whether clicking the box, and Alt+Down, are stopped from opening the drop-down.

Value: true to block them; the default is false.

Remarks

Use it to make the box display-only for a while, such as while the items are being loaded. Only mouse clicks and Alt+Down are blocked.

IsFilterSearchResultBasedOnColumnDataType

public new object IsFilterSearchResultBasedOnColumnDataType

Hidden. This control inherits is filter search result based on column data type from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

IsTextSelectedUponGainingFocus

public bool IsTextSelectedUponGainingFocus

Gets or sets whether the box's text is left selected when the box gains the focus.

Value: true to leave it as the combo box selects it; false (the default) to clear the selection and put the insertion point at the end.

ItemSelectionClick

public new object ItemSelectionClick

Hidden. This control inherits item selection click from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

KeepBindingContextInSyncWithParent

public new object KeepBindingContextInSyncWithParent

Hidden. This control inherits keep binding context in sync with parent from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

KeepTheFilterAndGroupingViewsCollapsedAtStartUp

public new object KeepTheFilterAndGroupingViewsCollapsedAtStartUp

Hidden. This control inherits keep the filter and grouping views collapsed at start up from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

KeepTheFilterAndGroupingViewsPaneFullyCollapsedAtStartup

public new object KeepTheFilterAndGroupingViewsPaneFullyCollapsedAtStartup

Hidden. This control inherits keep the filter and grouping views pane fully collapsed at startup from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropDownSize

public new object MultiColumnDropDownSize

Hidden. This control inherits multi column drop down size from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropDownWindowBorderThickness

public new object MultiColumnDropDownWindowBorderThickness

Hidden. This control inherits multi column drop down window border thickness from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropDownWindowConfigurationData

public new object MultiColumnDropDownWindowConfigurationData

Hidden. This control inherits multi column drop down window configuration data from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListBackColor

public new object MultiColumnDropListBackColor

Hidden. This control inherits multi column drop list back color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListFont

public new object MultiColumnDropListFont

Hidden. This control inherits multi column drop list font from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListForeColor

public new object MultiColumnDropListForeColor

Hidden. This control inherits multi column drop list fore color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListGridLines

public new object MultiColumnDropListGridLines

Hidden. This control inherits multi column drop list grid lines from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListHoverSelection

public new object MultiColumnDropListHoverSelection

Hidden. This control inherits multi column drop list hover selection from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDropListWindowIsResizable

public new object MultiColumnDropListWindowIsResizable

Hidden. This control inherits multi column drop list window is resizable from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnDroplistWindowAnimationStyle

public new object MultiColumnDroplistWindowAnimationStyle

Hidden. This control inherits multi column droplist window animation style from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnViewBusyProcessingText

public new object MultiColumnViewBusyProcessingText

Hidden. This control inherits multi column view busy processing text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnViewNoDataFoundText

public new object MultiColumnViewNoDataFoundText

Hidden. This control inherits multi column view no data found text from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnViewSortingGlyphColor

public new object MultiColumnViewSortingGlyphColor

Hidden. This control inherits multi column view sorting glyph color from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnViewUIElementsTextProvider

public new object MultiColumnViewUIElementsTextProvider

Hidden. This control inherits multi column view UI elements text provider from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiColumnWindowColumnsHorizontalAlignments

public new object MultiColumnWindowColumnsHorizontalAlignments

Hidden. This control inherits multi column window columns horizontal alignments from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

MultiSelectableCheckedImageListBoxConfiguration

public CheckedImageListBoxConfiguration MultiSelectableCheckedImageListBoxConfiguration

Gets or sets the items of the drop-down list and its look.

Value: A configuration with no items and the combo box's default look, to begin with.

Remarks

Read each time the drop-down opens. Assigning null is replaced by a new, empty configuration at the next open.

RaiseNotInListWhenTyping

public new object RaiseNotInListWhenTyping

Hidden. This control inherits raise not in list when typing from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShareCustomMultiColumnSizeAcrossDataListAndFilterGroupingOptionsPane

public new object ShareCustomMultiColumnSizeAcrossDataListAndFilterGroupingOptionsPane

Hidden. This control inherits share custom multi column size across data list and filter grouping options pane from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShouldAllowDragDropOfColumns

public new object ShouldAllowDragDropOfColumns

Hidden. This control inherits should allow drag drop of columns from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShouldAllowUserInputWhileProcessingMultiColumnAutoCompleDropDownView

public new object ShouldAllowUserInputWhileProcessingMultiColumnAutoCompleDropDownView

Hidden. This control inherits should allow user input while processing multi column auto comple drop down view from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShouldApplyMultiColumnWindowColumnsAlignmentsToAutoCompleteDropDown

public new object ShouldApplyMultiColumnWindowColumnsAlignmentsToAutoCompleteDropDown

Hidden. This control inherits should apply multi column window columns alignments to auto complete drop down from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShouldDisplayColumnHeadersWhenInMultiColumnMode

public new object ShouldDisplayColumnHeadersWhenInMultiColumnMode

Hidden. This control inherits should display column headers when in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShouldDrawBidirectionalResizeGripper

public bool ShouldDrawBidirectionalResizeGripper

Gets or sets whether the standard size grip is drawn in the corner of the band under the drop-down list.

Value: true to draw it; the default is true.

ShouldDrawDropdownResizeSectionWith3DBorder

public bool ShouldDrawDropdownResizeSectionWith3DBorder

Gets or sets whether the band under the drop-down list has a raised 3-D edge instead of a line in DropdownResizeSectionBorderColor.

Value: true for the 3-D edge; the default is false.

ShouldDrawVerticalResizeGripper

public bool ShouldDrawVerticalResizeGripper

Gets or sets whether a small triangle of lines is drawn in the middle of the band under the drop-down list, to show it can be dragged.

Value: true to draw it; the default is true.

Remarks

It is drawn in DropdownResizeGripperColor, which by default is transparent – set that colour to see it.

ShouldPersistUserSetColumnWidthsAcrossFilterSessions

public new object ShouldPersistUserSetColumnWidthsAcrossFilterSessions

Hidden. This control inherits should persist user set column widths across filter sessions from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShowDropDownMultiColumnWindowAfterAdjustingForVirtualAvaliableScreenSpace

public new object ShowDropDownMultiColumnWindowAfterAdjustingForVirtualAvaliableScreenSpace

Hidden. This control inherits show drop down multi column window after adjusting for virtual avaliable screen space from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShowEmptyDropListViewWhenThereAreNoData

public new object ShowEmptyDropListViewWhenThereAreNoData

Hidden. This control inherits show empty drop list view when there are no data from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ShowFilterOptionsInMultiColumnMode

public new object ShowFilterOptionsInMultiColumnMode

Hidden. This control inherits show filter options in multi column mode from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

SizeForMultiColumnAutoCompleteSuggestionDropDownWindow

public new object SizeForMultiColumnAutoCompleteSuggestionDropDownWindow

Hidden. This control inherits size for multi column auto complete suggestion drop down window from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

SizesForMultiColumnAutoCompleteSuggestionDropDownWindowColumns

public new object SizesForMultiColumnAutoCompleteSuggestionDropDownWindowColumns

Hidden. This control inherits sizes for multi column auto complete suggestion drop down window columns from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

Sorted

public new object Sorted

Hidden. This control inherits sorted from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

TableToLoad

public new object TableToLoad

Hidden. This control inherits table to load from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

ToggleCheckStateForAllItems

public bool ToggleCheckStateForAllItems

Gets or sets the check state of every item at once: true checks them all, false clears them all.

Value: The value last set; the default is false. It does not follow checks the user makes one by one.

Remarks

Setting it rebuilds the box's text and raises AllItemsCheckedOrUncheckedChanged, even when the value is unchanged.

Example

selectAll.CheckedChanged += (sender, e) =>
    toppings.ToggleCheckStateForAllItems = selectAll.Checked;

ValueMember

public new object ValueMember

Hidden. This control inherits value member from its base class but does not use it, so it is kept out of the designer and out of IntelliSense.

Methods

OnAllItemsCheckedOrUncheckedChanged

protected virtual void OnAllItemsCheckedOrUncheckedChanged(object sender, EventArgs e)

Rebuilds the box's text and raises AllItemsCheckedOrUncheckedChanged.

Parameters

sender: The control whose items changed; nothing happens if it is not a MultiSelectableCheckedImageListCombobox.
e: The event data.

OnDropDown

protected override void OnDropDown(EventArgs e)

Opens the checked list below the box, in place of the standard list: copies the configuration and the items to it and shows it at DropdownSize.

Parameters

e: The event data.

Remarks

The standard ComboBox.DropDown event is not raised.

OnGotFocus

protected override void OnGotFocus(EventArgs e)

Raises Control.GotFocus, hides the insertion point and, unless IsTextSelectedUponGainingFocus is on, clears the selection.

Parameters

e: The event data.

OnHandleCreated

protected override void OnHandleCreated(EventArgs e)

Raises Control.HandleCreated, clears the text and makes the text area read-only.

Parameters

e: The event data.

OnItemCheckStateChanged

protected virtual void OnItemCheckStateChanged(object sender, CheckedImageListBoxItemCheckStateChangedEventArgs e)

Rebuilds the box's text after the user checks or unchecks an item. ItemCheckStateChanged is raised after this method returns.

Parameters

sender: The control whose item changed.
e: The item and its new state.

OnTextChanged

protected override void OnTextChanged(EventArgs te)

Raises Control.TextChanged and hides the insertion point.

Parameters

te: The event data.

OnTextUpdate

protected override void OnTextUpdate(EventArgs e)

Raises ComboBox.TextUpdate and hides the insertion point, since the text is not typed.

Parameters

e: The event data.

PreProcessMessage

public override bool PreProcessMessage(ref Message msg)

Pre-processes keyboard messages, dropping Alt+Down while IsDropdownInvocationBlocked is on.

Parameters

msg: The message.

Returns

true when the message was handled.

SetItemCheckState

public void SetItemCheckState(int index, bool newState)

Checks or unchecks one item from code.

Parameters

index: The item's position in CheckedImageListBoxConfiguration.Items.
newState: true to check the item, false to clear it.

Exceptions

ArgumentOutOfRangeException: index is outside the items (when there are any).

Remarks

It sets the item's CheckedImageListBoxItem.IsChecked and rebuilds the box's text. Does nothing when there are no items.

WndProc

protected override void WndProc(ref Message m)

Processes the control's window messages, dropping mouse clicks while IsDropdownInvocationBlocked is on.

Parameters

m: The message.

Events

AllItemsCheckedOrUncheckedChanged

public event EventHandler AllItemsCheckedOrUncheckedChanged

Occurs when ToggleCheckStateForAllItems is set, after every item has been checked or cleared and the box's text rebuilt.

ItemCheckStateChanged

public event EventHandler<CheckedImageListBoxItemCheckStateChangedEventArgs> ItemCheckStateChanged

Occurs when the user checks or unchecks an item in the drop-down list, after the box's text has been rebuilt.

Remarks

The sender is this control. Not raised by SetItemCheckState or by ToggleCheckStateForAllItems.

MultiSelectableCheckedImageListCombobox

Remarks

Items

What the box shows

The drop-down

Reading the choice

Examples

See also

Members at a glance

Constructors

MultiSelectableCheckedImageListCombobox

Properties

AnimateDropDownWindow

AnimationInterval

AutoComplete

AutoCompleteBasedOnCompleteMatchWithAnItemInTheList

AutoCompleteCustomSource

AutoCompleteIsCaseSensitive

AutoCompleteMode

AutoCompleteSource

AutoCompleteStyleForMultiColumnModeIsMultiColumn

BuiltinFilterOnNonStringTypeColumnFilterMode

BuiltinFilterOnStringTypeColumnFilterMode

BusyIndicatorText

CSVFileSaveAs

CheckedIndices

Remarks

See also

CheckedItemTextDisplaySeparationDelimiterChars

Remarks

See also

CheckedItems

Remarks

See also

ColumnDataTypeFormatInfoContainers

ColumnWidths

ColumnsToDisplay

CustomColumnNameForAutomaticRowSelection

CustomComparerImplementor

CustomDropDownWindowLocationPoint

DataMember

DataSource

DataSourceViewCustomSortingExpression

DesiredFilterColumn

DisplayLocation

Remarks

DisplayMember

Remarks

See also

DrawMode

DropDownHeight

DropDownItemBorderColor

DropDownItemTextAlignment

DropDownStyle

DropDownWidth

DropDownWindowDisplayOrientation

DropStyleIsMultiColumn

DropdownContentMargin

DropdownContentPadding

DropdownResizeGripperColor

See also

DropdownResizeSectionBorderColor

Remarks

DropdownResizeSectionFillColor

DropdownSize

Remarks

EnableAlphaBlendingForFilterAndGroupingPanelBackColor

EnableColumnSorting

EnableDrawingHeaderFooterWhenInMultiColumnMode

EnableUserColumnResizing

EnforceItemsInList

FilterAndGroupingPanelBackColor

FilteringIsON

FormatString

FormattingEnabled

GroupItemsWhenInMultiColumnDisplayMode

GroupMultiColumnDisplayModeDataBasedOnThisColumn

HeadersToDisplay

IsAutoCompleteModeAppendSuggestInMultiColumnMode

IsCustomisationOfColumnDisplayEnabledInMultiColumnAutoSuggestMode