C1CheckList Class

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

Inheritance

object

MarshalByRefObject

Component

Control

XViewHost

C1CheckList

Implements

Namespace: C1.Win.TreeView

Assembly: C1.Win.TreeView.10.dll

Syntax

[ToolboxBitmap(typeof(C1CheckList), "C1CheckList.png")]
public class C1CheckList : XViewHost, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

<ToolboxBitmap(GetType(C1CheckList), "C1CheckList.png")>
Public Class C1CheckList
    Inherits XViewHost
    Implements 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.