[]
        
(Showing Draft Content)

C1.Win.TreeView.C1CheckList

C1CheckList Class

A list-based control with optional check boxes for each item, different selection modes and ability to select/unselect all items.

Namespace: C1.Win.TreeView
Assembly: C1.Win.TreeView.4.8.dll
Syntax
[ToolboxBitmap(typeof(C1CheckList), "C1CheckList.png")]
public class C1CheckList : XViewHost, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Constructors

Name Description
C1CheckList()

Initializes a new instance of the C1CheckList class.

Properties

Name Description
BackColor
BindingInfo

Contains information about a data binding.

BorderColor

Gets or sets the color of the control border.

BorderStyle

Gets or sets the BorderStyle value determining the type of border around the control.

CheckImageList

Gets the image list that is used to indicate the state of the C1CheckList items.

DefaultSize
Items

Gets the collection of items in this C1CheckList.

RightClickSelect

Gets or sets a value indicating whether a item can be selected by right click or not.

SelectAllCaption

Gets or sets the caption for Select All checkbox.

SelectedIndex

Gets or sets the index of the currently selected item in the list. A zero-based index of the currently selected item. A value of negative one (-1) is returned if no item is selected. When SelectionMode is Single then only one item remains selected.

SelectedItem

Gets or sets the item that is currently selected in the list.

SelectedItems

Gets the collection of selected items in this C1CheckList.

SelectedValues

Gets the array of selected item values in this C1CheckList.

SelectionMode

Gets or sets a value indicating how the items of the C1CheckList control can be selected. SelectionMode is of type enumeration SelectionMode. The default is Multiple. When SelectionMode was changed value to Single then one item remains selected.

ShowCheckBoxes

Gets or sets a value indicating whether check boxes should be visible or not.

ShowSelectAll

Gets or sets a value that indicates whether show select all checkbox or not.

Styles

Gets or sets styles.

UnselectAllCaption

Gets or sets the Caption for Unselect All checkbox.

Methods

Name Description
Dispose(bool)

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Focus(C1CheckListItem)

Sets focus to a C1CheckList item.

OnApplyItemStyles(C1CheckListItemStylesEventArgs)

Fires the ApplyItemStyles event.

OnItemValueChanged(C1CheckListEventArgs)

Fires the ItemValueChanged event.

OnSelectionChanged(EventArgs)

Fires the SelectionChanged event.

RaiseApplyItemStyles(C1CheckListItem)

Raises the ApplyItemStyles event.

ResetBorderColor()
ResetCheckImageList()

Resets the CheckImageList property to its default value.

ResetStyles()

Resets the Styles property to its default value.

ResumeSelection()

Resumes calls to the SelectionChanged event.

ScrollToItem(C1CheckListItem)

Scrolls the C1CheckList to a specific item.

SelectAll()

Selects all items of the current C1CheckList control.

ShouldSerializeBorderColor()
ShouldSerializeCheckImageList()

Returns true if this CheckImageList property has changed; otherwise, returns false.

ShouldSerializeStyles()

Returns true if this Styles property has changed; otherwise, returns false.

SuspendSelection()

Temporarily suspends calls to the SelectionChanged event.

UnselectAll()

Cancel the selection of all items of the current C1CheckList control.

Events

Name Description
ApplyItemStyles

Occurs before applying styles to a list item.

ItemValueChanged

Occurs when the item value changed.

SelectionChanged

Occurs when the selected state of item was changed.