WinForms › Checked Image List Combobox › MultiSelectableCheckedImageListCombobox

MultiSelectableCheckedImageListCombobox

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

A custom control that acts as a combobox control, and also allows to drop-down an advanced checked-listbox view that can also host images alongside the contained items.

public partial class MultiSelectableCheckedImageListCombobox : BinaryTextComboBox

Inherits from / implements: BinaryTextComboBox

Members at a glance

`MultiSelectableCheckedImageListCombobox`	Initializes a new instance of the `MultiSelectableCheckedImageListCombobox` class.
`CheckedIndices`	Gets the checked items' indices.
`CheckedItemTextDisplaySeparationDelimiterChars`	Gets or sets the checked data text display separation delimiter string.
`CheckedItems`	Gets the checked items.
`DisplayLocation`	Gets or sets the display location for the drop-down view.
`DisplayMember`	Gets or sets the property name whose value the control will lookup in order to set the text for displaying in the combobox text area, as and when the user selects an items from the drop-down checked-listbox view.
`DropdownContentMargin`	Gets or sets the dropdown content margin.
`DropdownContentPadding`	Gets or sets the dropdown content padding.
`DropdownResizeGripperColor`	Gets or sets the color of the dropdown resize gripper.
`DropdownResizeSectionBorderColor`	Gets or sets the color of the dropdown resize section border.
`DropdownResizeSectionFillColor`	Gets or sets the fill color for the dropdown resize section.
`DropdownSize`	Gets or sets the size of the drop-down list view.
`IsDropdownInvocationBlocked`	Gets or sets the whether this instance's dropdown invocation is blocked.
`IsTextSelectedUponGainingFocus`	Gets or sets whether the control's text is selected upon gaining focus.
`MultiSelectableCheckedImageListBoxConfiguration`	Gets or sets the multi-selectable checked-image-ListBox configuration.
`ShouldDrawBidirectionalResizeGripper`	Gets or sets a value indicating whether the control should draw bidirectional resize gripper.
`ShouldDrawDropdownResizeSectionWith3DBorder`	Gets or sets whether the control should draw its dropdown resize section with 3D border.
`ShouldDrawVerticalResizeGripper`	Gets or sets a value indicating whether the control should draw vertical resize gripper.
`ToggleCheckStateForAllItems`	Gets or sets the toggled check/uncheck state for all items.
`OnAllItemsCheckedOrUncheckedChanged`	Handles the `AllItemsCheckedOrUncheckedChanged` event.
`OnDropDown`	Handles the `DropDown` event.
`OnGotFocus`	Handles the `GotFocus` event.
`OnHandleCreated`	Handles the `HandleCreated` event.
`OnItemCheckStateChanged`	Handles the `ItemCheckStateChanged` event.
`OnTextChanged`	Handles the `TextChanged` event.
`OnTextUpdate`	Handles the `TextUpdate` event.
`PreProcessMessage`	Preprocesses the windows message.
`SetItemCheckState`	Sets the check-state of the item.
`WndProc`	The core Windows message processor.
`AllItemsCheckedOrUncheckedChanged`	Occurs when all items in the control are checked or unchecked by setting the `ToggleCheckStateForAllItems` property.
`ItemCheckStateChanged`	Occurs when the item check state is changed.

Constructors

MultiSelectableCheckedImageListCombobox

public MultiSelectableCheckedImageListCombobox()

Initializes a new instance of the MultiSelectableCheckedImageListCombobox class.

Properties

CheckedIndices

public IList<int> CheckedIndices

Gets the checked items' indices.

CheckedItemTextDisplaySeparationDelimiterChars

public string CheckedItemTextDisplaySeparationDelimiterChars

Gets or sets the checked data text display separation delimiter string.

CheckedItems

public IList<CheckedImageListBoxItem> CheckedItems

Gets the checked items.

DisplayLocation

public Point DisplayLocation

Gets or sets the display location for the drop-down view.

DisplayMember

public new string DisplayMember

Gets or sets the property name whose value the control will lookup in order to set the text for displaying in the combobox text area, as and when the user selects an items from the drop-down checked-listbox view.

Value. The display member.

DropdownContentMargin

public Padding DropdownContentMargin

Gets or sets the dropdown content margin.

DropdownContentPadding

public Padding DropdownContentPadding

Gets or sets the dropdown content padding.

DropdownResizeGripperColor

public Color DropdownResizeGripperColor

Gets or sets the color of the dropdown resize gripper.

DropdownResizeSectionBorderColor

public Color DropdownResizeSectionBorderColor

Gets or sets the color of the dropdown resize section border.

DropdownResizeSectionFillColor

public Color DropdownResizeSectionFillColor

Gets or sets the fill color for the dropdown resize section.

DropdownSize

public Size DropdownSize

Gets or sets the size of the drop-down list view.

IsDropdownInvocationBlocked

public bool IsDropdownInvocationBlocked

Gets or sets the whether this instance's dropdown invocation is blocked.

IsTextSelectedUponGainingFocus

public bool IsTextSelectedUponGainingFocus

Gets or sets whether the control's text is selected upon gaining focus.

MultiSelectableCheckedImageListBoxConfiguration

public CheckedImageListBoxConfiguration MultiSelectableCheckedImageListBoxConfiguration

Gets or sets the multi-selectable checked-image-ListBox configuration.

ShouldDrawBidirectionalResizeGripper

public bool ShouldDrawBidirectionalResizeGripper

Gets or sets a value indicating whether the control should draw bidirectional resize gripper.

ShouldDrawDropdownResizeSectionWith3DBorder

public bool ShouldDrawDropdownResizeSectionWith3DBorder

Gets or sets whether the control should draw its dropdown resize section with 3D border.

ShouldDrawVerticalResizeGripper

public bool ShouldDrawVerticalResizeGripper

Gets or sets a value indicating whether the control should draw vertical resize gripper.

ToggleCheckStateForAllItems

public bool ToggleCheckStateForAllItems

Gets or sets the toggled check/uncheck state for all items.

Methods

OnAllItemsCheckedOrUncheckedChanged

protected virtual void OnAllItemsCheckedOrUncheckedChanged(object sender, EventArgs e)

Handles the AllItemsCheckedOrUncheckedChanged event.

sender: The sender.
e: The EventArgs instance containing the event data.

OnDropDown

protected override void OnDropDown(EventArgs e)

Handles the DropDown event.

e: The EventArgs instance containing the event data.

OnGotFocus

protected override void OnGotFocus(EventArgs e)

Handles the GotFocus event.

e: The EventArgs instance containing the event data.

OnHandleCreated

protected override void OnHandleCreated(EventArgs e)

Handles the HandleCreated event.

e: The EventArgs instance containing the event data.

OnItemCheckStateChanged

protected virtual void OnItemCheckStateChanged(object sender, CheckedImageListBoxItemCheckStateChangedEventArgs e)

Handles the ItemCheckStateChanged event.

sender: The sender.
e: The ItemCheckStateChangedEventArgs instance containing the event data.

OnTextChanged

protected override void OnTextChanged(EventArgs te)

Handles the TextChanged event.

te: The EventArgs instance containing the event data.

OnTextUpdate

protected override void OnTextUpdate(EventArgs e)

Handles the TextUpdate event.

e: The EventArgs instance containing the event data.

PreProcessMessage

public override bool PreProcessMessage(ref Message msg)

Preprocesses the windows message.

SetItemCheckState

public void SetItemCheckState(int index, bool newState)

Sets the check-state of the item.

index: The index.
newState: if set to true the item's check-state will be set to checked, otherwise unchecked.

WndProc

protected override void WndProc(ref Message m)

The core Windows message processor.

Events

AllItemsCheckedOrUncheckedChanged

public event EventHandler AllItemsCheckedOrUncheckedChanged

Occurs when all items in the control are checked or unchecked by setting the ToggleCheckStateForAllItems property.

ItemCheckStateChanged

public event EventHandler<CheckedImageListBoxItemCheckStateChangedEventArgs> ItemCheckStateChanged

Occurs when the item check state is changed.