Export (0) Print
Expand All

CheckedListBox Class

Displays a ListBox in which a check box is displayed to the left of each item.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[LookupBindingPropertiesAttribute]
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class CheckedListBox : ListBox

The CheckedListBox type exposes the following members.

  NameDescription
Public methodCheckedListBoxInitializes a new instance of the CheckedListBox class.
Top

  NameDescription
Public propertyAccessibilityObjectGets the AccessibleObject assigned to the control. (Inherited from Control.)
Public propertyAccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleDescriptionGets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleNameGets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleRoleGets or sets the accessible role of the control (Inherited from Control.)
Public propertyAllowDropGets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.)
Protected propertyAllowSelectionGets a value indicating whether the ListBox currently enables selection of list items. (Inherited from ListBox.)
Public propertyAnchorGets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control.)
Public propertyAutoScrollOffsetGets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
Public propertyAutoSizeInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Public propertyBackColorGets or sets the background color for the control. (Inherited from ListBox.)
Public propertyBackgroundImageInfrastructure. This property is not relevant to this class. (Inherited from ListBox.)
Public propertyBackgroundImageLayoutInfrastructure. Gets or sets the background image layout for a ListBox as defined in the ImageLayout enumeration. (Inherited from ListBox.)
Public propertyBindingContextGets or sets the BindingContext for the control. (Inherited from Control.)
Public propertyBorderStyleGets or sets the type of border that is drawn around the ListBox. (Inherited from ListBox.)
Public propertyBottomGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyBoundsGets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.)
Protected propertyCanEnableImeGets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from Control.)
Public propertyCanFocusGets a value indicating whether the control can receive focus. (Inherited from Control.)
Protected propertyCanRaiseEventsDetermines if events can be raised on the control. (Inherited from Control.)
Public propertyCanSelectGets a value indicating whether the control can be selected. (Inherited from Control.)
Public propertyCaptureGets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
Public propertyCausesValidationGets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control.)
Public propertyCheckedIndicesCollection of checked indexes in this CheckedListBox.
Public propertyCheckedItemsCollection of checked items in this CheckedListBox.
Public propertyCheckOnClickGets or sets a value indicating whether the check box should be toggled when an item is selected.
Public propertyClientRectangleGets the rectangle that represents the client area of the control. (Inherited from Control.)
Public propertyClientSizeGets or sets the height and width of the client area of the control. (Inherited from Control.)
Public propertyColumnWidthGets or sets the width of columns in a multicolumn ListBox. (Inherited from ListBox.)
Public propertyCompanyNameGets the name of the company or creator of the application containing the control. (Inherited from Control.)
Public propertyContainerGets the IContainer that contains the Component. (Inherited from Component.)
Public propertyContainsFocusGets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
Public propertyContextMenuGets or sets the shortcut menu associated with the control. (Inherited from Control.)
Public propertyContextMenuStripGets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
Public propertyControlsGets the collection of controls contained within the control. (Inherited from Control.)
Public propertyCreatedGets a value indicating whether the control has been created. (Inherited from Control.)
Protected propertyCreateParamsGets the required creation parameters when the control handle is created. (Overrides ListBox.CreateParams.)
Public propertyCursorGets or sets the cursor that is displayed when the mouse pointer is over the control. (Inherited from Control.)
Public propertyCustomTabOffsetsGets the width of the tabs between the items in the ListBox. (Inherited from ListBox.)
Public propertyDataBindingsGets the data bindings for the control. (Inherited from Control.)
Protected propertyDataManagerGets the CurrencyManager associated with this control. (Inherited from ListControl.)
Public propertyDataSourceGets or sets the data source for the control.
Protected propertyDefaultCursorGets or sets the default cursor for the control. (Inherited from Control.)
Protected propertyDefaultImeModeGets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control.)
Protected propertyDefaultMarginGets the space, in pixels, that is specified by default between controls. (Inherited from Control.)
Protected propertyDefaultMaximumSizeGets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control.)
Protected propertyDefaultMinimumSizeGets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control.)
Protected propertyDefaultPaddingGets the internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
Protected propertyDefaultSizeGets the default size of the control. (Inherited from ListBox.)
Protected propertyDesignModeGets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public propertyDisplayMemberGets or sets a string that specifies a property of the objects contained in the list box whose contents you want to display.
Public propertyDisplayRectangleGets the rectangle that represents the display area of the control. (Inherited from Control.)
Public propertyDisposingGets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
Public propertyDockGets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. (Inherited from Control.)
Protected propertyDoubleBufferedGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. (Inherited from Control.)
Public propertyDrawModeInfrastructure. Gets a value indicating the mode for drawing elements of the CheckedListBox. This property is not relevant to this class. (Overrides ListBox.DrawMode.)
Public propertyEnabledGets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.)
Protected propertyEventsGets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public propertyFocusedGets a value indicating whether the control has input focus. (Inherited from Control.)
Public propertyFontGets or sets the font of the text displayed by the control. (Inherited from ListBox.)
Protected propertyFontHeightGets or sets the height of the font of the control. (Inherited from Control.)
Public propertyForeColorGets or sets the foreground color of the control. (Inherited from ListBox.)
Public propertyFormatInfoGets or sets the IFormatProvider that provides custom formatting behavior. (Inherited from ListControl.)
Public propertyFormatStringGets or sets the format-specifier characters that indicate how a value is to be displayed. (Inherited from ListControl.)
Public propertyFormattingEnabledGets or sets a value indicating whether formatting is applied to the DisplayMember property of the ListControl. (Inherited from ListControl.)
Public propertyHandleGets the window handle that the control is bound to. (Inherited from Control.)
Public propertyHasChildrenGets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
Public propertyHeightGets or sets the height of the control. (Inherited from Control.)
Public propertyHorizontalExtentGets or sets the width by which the horizontal scroll bar of a ListBox can scroll. (Inherited from ListBox.)
Public propertyHorizontalScrollbarGets or sets a value indicating whether a horizontal scroll bar is displayed in the control. (Inherited from ListBox.)
Public propertyImeModeGets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control.)
Protected propertyImeModeBaseGets or sets the IME mode of a control. (Inherited from Control.)
Public propertyIntegralHeightGets or sets a value indicating whether the control should resize to avoid showing partial items. (Inherited from ListBox.)
Public propertyInvokeRequiredGets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control.)
Public propertyIsAccessibleGets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
Public propertyIsDisposedGets a value indicating whether the control has been disposed of. (Inherited from Control.)
Public propertyIsHandleCreatedGets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
Public propertyIsMirroredGets a value indicating whether the control is mirrored. (Inherited from Control.)
Public propertyItemHeightGets the height of the item area. (Overrides ListBox.ItemHeight.)
Public propertyItemsGets the collection of items in this CheckedListBox.
Public propertyLayoutEngineGets a cached instance of the control's layout engine. (Inherited from Control.)
Public propertyLeftGets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyLocationGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control.)
Public propertyMarginGets or sets the space between controls. (Inherited from Control.)
Public propertyMaximumSizeGets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyMinimumSizeGets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyMultiColumnGets or sets a value indicating whether the ListBox supports multiple columns. (Inherited from ListBox.)
Public propertyNameGets or sets the name of the control. (Inherited from Control.)
Public propertyPaddingGets or sets padding within the CheckedListBox. This property is not relevant to this class.
Public propertyParentGets or sets the parent container of the control. (Inherited from Control.)
Public propertyPreferredHeightGets the combined height of all items in the ListBox. (Inherited from ListBox.)
Public propertyPreferredSizeGets the size of a rectangular area into which the control can fit. (Inherited from Control.)
Public propertyProductNameGets the product name of the assembly containing the control. (Inherited from Control.)
Public propertyProductVersionGets the version of the assembly containing the control. (Inherited from Control.)
Public propertyRecreatingHandleGets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
Public propertyRegionGets or sets the window region associated with the control. (Inherited from Control.)
Protected propertyRenderRightToLeft Obsolete. This property is now obsolete. (Inherited from Control.)
Protected propertyResizeRedrawGets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control.)
Public propertyRightGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyRightToLeftGets or sets a value indicating whether text displayed by the control is displayed from right to left. (Inherited from ListBox.)
Protected propertyScaleChildrenGets a value that determines the scaling of child controls. (Inherited from Control.)
Public propertyScrollAlwaysVisibleGets or sets a value indicating whether the vertical scroll bar is shown at all times. (Inherited from ListBox.)
Public propertySelectedIndexGets or sets the zero-based index of the currently selected item in a ListBox. (Inherited from ListBox.)
Public propertySelectedIndicesGets a collection that contains the zero-based indexes of all currently selected items in the ListBox. (Inherited from ListBox.)
Public propertySelectedItemGets or sets the currently selected item in the ListBox. (Inherited from ListBox.)
Public propertySelectedItemsGets a collection containing the currently selected items in the ListBox. (Inherited from ListBox.)
Public propertySelectedValueGets or sets the value of the member property specified by the ValueMember property. (Inherited from ListControl.)
Public propertySelectionModeGets or sets a value specifying the selection mode. (Overrides ListBox.SelectionMode.)
Protected propertyShowFocusCuesGets a value indicating whether the control should display focus rectangles. (Inherited from Control.)
Protected propertyShowKeyboardCuesGets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.)
Public propertySiteGets or sets the site of the control. (Inherited from Control.)
Public propertySizeGets or sets the height and width of the control. (Inherited from Control.)
Public propertySortedGets or sets a value indicating whether the items in the ListBox are sorted alphabetically. (Inherited from ListBox.)
Public propertyTabIndexGets or sets the tab order of the control within its container. (Inherited from Control.)
Public propertyTabStopGets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
Public propertyTagGets or sets the object that contains data about the control. (Inherited from Control.)
Public propertyTextGets or searches for the text of the currently selected item in the ListBox. (Inherited from ListBox.)
Public propertyThreeDCheckBoxesGets or sets a value indicating whether the check boxes have a System.Windows.Forms.ButtonState of Flat or Normal.
Public propertyTopGets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyTopIndexGets or sets the index of the first visible item in the ListBox. (Inherited from ListBox.)
Public propertyTopLevelControlGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control.)
Public propertyUseCompatibleTextRenderingGets or sets a value that determines whether to use the Graphics class (GDI+) or the TextRenderer class (GDI) to render text.
Public propertyUseCustomTabOffsetsGets or sets a value indicating whether the ListBox recognizes and expands tab characters when it draws its strings by using the CustomTabOffsets integer array. (Inherited from ListBox.)
Public propertyUseTabStopsGets or sets a value indicating whether the ListBox can recognize and expand tab characters when drawing its strings. (Inherited from ListBox.)
Public propertyUseWaitCursorGets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.)
Public propertyValueMemberGets or sets a string that specifies the property of the data source from which to draw the value.
Public propertyVisibleGets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
Public propertyWidthGets or sets the width of the control. (Inherited from Control.)
Public propertyWindowTargetInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Top

  NameDescription
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
Protected methodAddItemsCore Obsolete. This member is obsolete, and there is no replacement. (Inherited from ListBox.)
Public methodBeginInvoke(Delegate)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBeginInvoke(Delegate, Object[])Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBeginUpdateMaintains performance while items are added to the ListBox one at a time by preventing the control from drawing until the EndUpdate method is called. (Inherited from ListBox.)
Public methodBringToFrontBrings the control to the front of the z-order. (Inherited from Control.)
Public methodClearSelectedUnselects all items in the ListBox. (Inherited from ListBox.)
Public methodContainsRetrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
Protected methodCreateAccessibilityInstanceCreates a new accessibility object for the CheckedListBox control. (Overrides Control.CreateAccessibilityInstance().)
Public methodCreateControlForces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
Protected methodCreateControlsInstanceCreates a new instance of the control collection for the control. (Inherited from Control.)
Public methodCreateGraphicsCreates the Graphics for the control. (Inherited from Control.)
Protected methodCreateHandleCreates a handle for the control. (Inherited from Control.)
Protected methodCreateItemCollectionCreates a new instance of the item collection. (Overrides ListBox.CreateItemCollection().)
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected methodDefWndProcSends the specified message to the default window procedure. (Inherited from Control.)
Protected methodDestroyHandleDestroys the handle associated with the control. (Inherited from Control.)
Public methodDispose()Releases all resources used by the Component. (Inherited from Component.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources. (Inherited from Control.)
Public methodDoDragDropBegins a drag-and-drop operation. (Inherited from Control.)
Public methodDrawToBitmapSupports rendering to the specified bitmap. (Inherited from Control.)
Public methodEndInvokeRetrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
Public methodEndUpdateResumes painting the ListBox control after painting is suspended by the BeginUpdate method. (Inherited from ListBox.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFilterItemOnProperty(Object)Retrieves the current value of the ListControl item, if it is a property of an object, given the item. (Inherited from ListControl.)
Protected methodFilterItemOnProperty(Object, String)Returns the current value of the ListControl item, if it is a property of an object given the item and the property name. (Inherited from ListControl.)
Protected methodFinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public methodFindFormRetrieves the form that the control is on. (Inherited from Control.)
Public methodFindString(String)Finds the first item in the ListBox that starts with the specified string. (Inherited from ListBox.)
Public methodFindString(String, Int32)Finds the first item in the ListBox that starts with the specified string. The search starts at a specific starting index. (Inherited from ListBox.)
Public methodFindStringExact(String)Finds the first item in the ListBox that exactly matches the specified string. (Inherited from ListBox.)
Public methodFindStringExact(String, Int32)Finds the first item in the ListBox that exactly matches the specified string. The search starts at a specific starting index. (Inherited from ListBox.)
Public methodFocusSets input focus to the control. (Inherited from Control.)
Protected methodGetAccessibilityObjectByIdRetrieves the specified AccessibleObject. (Inherited from Control.)
Protected methodGetAutoSizeModeRetrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodGetChildAtPoint(Point)Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
Public methodGetChildAtPoint(Point, GetChildAtPointSkip)Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.)
Public methodGetContainerControlReturns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetItemCheckedReturns a value indicating whether the specified item is checked.
Public methodGetItemCheckStateReturns a value indicating the check state of the current item.
Public methodGetItemHeightReturns the height of an item in the ListBox. (Inherited from ListBox.)
Public methodGetItemRectangleReturns the bounding rectangle for an item in the ListBox. (Inherited from ListBox.)
Public methodGetItemTextReturns the text representation of the specified item. (Inherited from ListControl.)
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetNextControlRetrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
Public methodGetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
Protected methodGetScaledBoundsRetrieves the bounds within which the ListBox is scaled. (Inherited from ListBox.)
Public methodGetSelectedReturns a value indicating whether the specified item is selected. (Inherited from ListBox.)
Protected methodGetServiceReturns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected methodGetStyleRetrieves the value of the specified control style bit for the control. (Inherited from Control.)
Protected methodGetTopLevelDetermines if the control is a top-level control. (Inherited from Control.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodHideConceals the control from the user. (Inherited from Control.)
Public methodIndexFromPoint(Point)Returns the zero-based index of the item at the specified coordinates. (Inherited from ListBox.)
Public methodIndexFromPoint(Int32, Int32)Returns the zero-based index of the item at the specified coordinates. (Inherited from ListBox.)
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected methodInitLayoutCalled after the control has been added to another container. (Inherited from Control.)
Public methodInvalidate()Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.)
Public methodInvalidate(Boolean)Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Region)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Region, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvoke(Delegate)Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
Public methodInvoke(Delegate, Object[])Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.)
Protected methodInvokeGotFocusRaises the GotFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeLostFocusRaises the LostFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeOnClickRaises the Click event for the specified control. (Inherited from Control.)
Protected methodInvokePaintRaises the Paint event for the specified control. (Inherited from Control.)
Protected methodInvokePaintBackgroundRaises the PaintBackground event for the specified control. (Inherited from Control.)
Protected methodIsInputCharDetermines if a character is an input character that the control recognizes. (Inherited from Control.)
Protected methodIsInputKeyHandles special input keys, such as PAGE UP, PAGE DOWN, HOME, END, and so on. (Inherited from ListControl.)
Protected methodMemberwiseClone()Creates a shallow copy of the current Object. (Inherited from Object.)
Protected methodMemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Protected methodNotifyInvalidateInfrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
Protected methodOnAutoSizeChangedRaises the AutoSizeChanged event. (Inherited from Control.)
Protected methodOnBackColorChangedRaises the BackColorChanged event. (Overrides Control.OnBackColorChanged(EventArgs).)
Protected methodOnBackgroundImageChangedRaises the BackgroundImageChanged event. (Inherited from Control.)
Protected methodOnBackgroundImageLayoutChangedRaises the BackgroundImageLayoutChanged event. (Inherited from Control.)
Protected methodOnBindingContextChangedRaises the BindingContextChanged event. (Inherited from ListControl.)
Protected methodOnCausesValidationChangedRaises the CausesValidationChanged event. (Inherited from Control.)
Protected methodOnChangeUICuesRaises the ChangeUICues event. (Inherited from ListBox.)
Protected methodOnClickRaises the Click event. (Overrides Control.OnClick(EventArgs).)
Protected methodOnClientSizeChangedRaises the ClientSizeChanged event. (Inherited from Control.)
Protected methodOnContextMenuChangedRaises the ContextMenuChanged event. (Inherited from Control.)
Protected methodOnContextMenuStripChangedRaises the ContextMenuStripChanged event. (Inherited from Control.)
Protected methodOnControlAddedRaises the ControlAdded event. (Inherited from Control.)
Protected methodOnControlRemovedRaises the ControlRemoved event. (Inherited from Control.)
Protected methodOnCreateControlRaises the CreateControl method. (Inherited from Control.)
Protected methodOnCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnDataSourceChangedRaises the DataSourceChanged event. (Inherited from ListBox.)
Protected methodOnDisplayMemberChangedRaises the DisplayMemberChanged event. (Inherited from ListBox.)
Protected methodOnDockChangedRaises the DockChanged event. (Inherited from Control.)
Protected methodOnDoubleClickRaises the DoubleClick event. (Inherited from Control.)
Protected methodOnDragDropRaises the DragDrop event. (Inherited from Control.)
Protected methodOnDragEnterRaises the DragEnter event. (Inherited from Control.)
Protected methodOnDragLeaveRaises the DragLeave event. (Inherited from Control.)
Protected methodOnDragOverRaises the DragOver event. (Inherited from Control.)
Protected methodOnDrawItemRaises the DrawItem event. (Overrides ListBox.OnDrawItem(DrawItemEventArgs).)
Protected methodOnEnabledChangedRaises the EnabledChanged event. (Inherited from Control.)
Protected methodOnEnterRaises the Enter event. (Inherited from Control.)
Protected methodOnFontChangedRaises the FontChanged event. (Overrides ListBox.OnFontChanged(EventArgs).)
Protected methodOnForeColorChangedRaises the ForeColorChanged event. (Inherited from Control.)
Protected methodOnFormatRaises the Format event. (Inherited from ListControl.)
Protected methodOnFormatInfoChangedRaises the FormatInfoChanged event. (Inherited from ListControl.)
Protected methodOnFormatStringChangedRaises the FormatStringChanged event. (Inherited from ListControl.)
Protected methodOnFormattingEnabledChangedRaises the FormattingEnabledChanged event. (Inherited from ListControl.)
Protected methodOnGiveFeedbackRaises the GiveFeedback event. (Inherited from Control.)
Protected methodOnGotFocusRaises the GotFocus event. (Inherited from Control.)
Protected methodOnHandleCreatedRaises the HandleCreated event. (Overrides ListBox.OnHandleCreated(EventArgs).)
Protected methodOnHandleDestroyedOverridden to be sure that items are set up and cleared out correctly. Inheriting controls should call base.OnHandleDestroyed. (Inherited from ListBox.)
Protected methodOnHelpRequestedRaises the HelpRequested event. (Inherited from Control.)
Protected methodOnImeModeChangedRaises the ImeModeChanged event. (Inherited from Control.)
Protected methodOnInvalidatedRaises the Invalidated event. (Inherited from Control.)
Protected methodOnItemCheckRaises the ItemCheck event.
Protected methodOnKeyDownRaises the KeyDown event. (Inherited from Control.)
Protected methodOnKeyPressRaises the KeyPress event. (Overrides Control.OnKeyPress(KeyPressEventArgs).)
Protected methodOnKeyUpRaises the KeyUp event. (Inherited from Control.)
Protected methodOnLayoutRaises the Layout event. (Inherited from Control.)
Protected methodOnLeaveRaises the Leave event. (Inherited from Control.)
Protected methodOnLocationChangedRaises the LocationChanged event. (Inherited from Control.)
Protected methodOnLostFocusRaises the LostFocus event. (Inherited from Control.)
Protected methodOnMarginChangedRaises the MarginChanged event. (Inherited from Control.)
Protected methodOnMeasureItemRaises the MeasureItem event. (Overrides ListBox.OnMeasureItem(MeasureItemEventArgs).)
Protected methodOnMouseCaptureChangedRaises the MouseCaptureChanged event. (Inherited from Control.)
Protected methodOnMouseClickRaises the MouseClick event. (Inherited from Control.)
Protected methodOnMouseDoubleClickRaises the MouseDoubleClick event. (Inherited from Control.)
Protected methodOnMouseDownRaises the MouseDown event. (Inherited from Control.)
Protected methodOnMouseEnterRaises the MouseEnter event. (Inherited from Control.)
Protected methodOnMouseHoverRaises the MouseHover event. (Inherited from Control.)
Protected methodOnMouseLeaveRaises the MouseLeave event. (Inherited from Control.)
Protected methodOnMouseMoveRaises the MouseMove event. (Inherited from Control.)
Protected methodOnMouseUpRaises the MouseUp event. (Inherited from Control.)
Protected methodOnMouseWheelRaises the MouseWheel event. (Inherited from Control.)
Protected methodOnMoveRaises the Move event. (Inherited from Control.)
Protected methodOnNotifyMessageNotifies the control of Windows messages. (Inherited from Control.)
Protected methodOnPaddingChangedRaises the PaddingChanged event. (Inherited from Control.)
Protected methodOnPaintRaises the Paint event. (Inherited from Control.)
Protected methodOnPaintBackgroundPaints the background of the control. (Inherited from Control.)
Protected methodOnParentBackColorChangedRaises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBackgroundImageChangedRaises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBindingContextChangedRaises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentChangedRaises the ParentChanged event. (Inherited from ListBox.)
Protected methodOnParentCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentFontChangedRaises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentForeColorChangedRaises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentRightToLeftChangedRaises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentVisibleChangedRaises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
Protected methodOnPreviewKeyDownRaises the PreviewKeyDown event. (Inherited from Control.)
Protected methodOnPrintRaises the Paint event. (Inherited from Control.)
Protected methodOnQueryContinueDragRaises the QueryContinueDrag event. (Inherited from Control.)
Protected methodOnRegionChangedRaises the RegionChanged event. (Inherited from Control.)
Protected methodOnResizeRaises the Resize event. (Inherited from ListBox.)
Protected methodOnRightToLeftChangedRaises the RightToLeftChanged event. (Inherited from Control.)
Protected methodOnSelectedIndexChangedRaises the SelectedIndexChanged event. (Overrides ListBox.OnSelectedIndexChanged(EventArgs).)
Protected methodOnSelectedValueChangedRaises the SelectedValueChanged event. (Inherited from ListBox.)
Protected methodOnSizeChangedRaises the SizeChanged event. (Inherited from Control.)
Protected methodOnStyleChangedRaises the StyleChanged event. (Inherited from Control.)
Protected methodOnSystemColorsChangedRaises the SystemColorsChanged event. (Inherited from Control.)
Protected methodOnTabIndexChangedRaises the TabIndexChanged event. (Inherited from Control.)
Protected methodOnTabStopChangedRaises the TabStopChanged event. (Inherited from Control.)
Protected methodOnTextChangedRaises the TextChanged event. (Inherited from Control.)
Protected methodOnValidatedRaises the Validated event. (Inherited from Control.)
Protected methodOnValidatingRaises the Validating event. (Inherited from Control.)
Protected methodOnValueMemberChangedRaises the ValueMemberChanged event. (Inherited from ListControl.)
Protected methodOnVisibleChangedRaises the VisibleChanged event. (Inherited from Control.)
Public methodPerformLayout()Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPerformLayout(Control, String)Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPointToClientComputes the location of the specified screen point into client coordinates. (Inherited from Control.)
Public methodPointToScreenComputes the location of the specified client point into screen coordinates. (Inherited from Control.)
Public methodPreProcessControlMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Public methodPreProcessMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Protected methodProcessCmdKeyProcesses a command key. (Inherited from Control.)
Protected methodProcessDialogCharProcesses a dialog character. (Inherited from Control.)
Protected methodProcessDialogKeyProcesses a dialog key. (Inherited from Control.)
Protected methodProcessKeyEventArgsProcesses a key message and generates the appropriate control events. (Inherited from Control.)
Protected methodProcessKeyMessageProcesses a keyboard message. (Inherited from Control.)
Protected methodProcessKeyPreviewPreviews a keyboard message. (Inherited from Control.)
Protected methodProcessMnemonicProcesses a mnemonic character. (Inherited from Control.)
Protected methodRaiseDragEventInfrastructure. Raises the appropriate drag event. (Inherited from Control.)
Protected methodRaiseKeyEventInfrastructure. Raises the appropriate key event. (Inherited from Control.)
Protected methodRaiseMouseEventInfrastructure. Raises the appropriate mouse event. (Inherited from Control.)
Protected methodRaisePaintEventInfrastructure. Raises the appropriate paint event. (Inherited from Control.)
Protected methodRecreateHandleForces the re-creation of the handle for the control. (Inherited from Control.)
Public methodRectangleToClientComputes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
Public methodRectangleToScreenComputes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
Public methodRefreshForces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from ListBox.)
Protected methodRefreshItemInfrastructure. Refreshes the item contained at the specified index. (Inherited from ListBox.)
Protected methodRefreshItemsParses all CheckedListBox items again and gets new text strings for the items. (Overrides ListBox.RefreshItems().)
Public methodResetBackColorResets the BackColor property to its default value. (Inherited from ListBox.)
Public methodResetBindingsCauses a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
Public methodResetCursorResets the Cursor property to its default value. (Inherited from Control.)
Public methodResetFontResets the Font property to its default value. (Inherited from Control.)
Public methodResetForeColorResets the ForeColor property to its default value. (Inherited from ListBox.)
Public methodResetImeModeResets the ImeMode property to its default value. (Inherited from Control.)
Protected methodResetMouseEventArgsInfrastructure. Resets the control to handle the MouseLeave event. (Inherited from Control.)
Public methodResetRightToLeftResets the RightToLeft property to its default value. (Inherited from Control.)
Public methodResetTextResets the Text property to its default value. (Inherited from Control.)
Public methodResumeLayout()Resumes usual layout logic. (Inherited from Control.)
Public methodResumeLayout(Boolean)Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
Protected methodRtlTranslateAlignment(ContentAlignment)Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(HorizontalAlignment)Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(LeftRightAlignment)Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateContentConverts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateHorizontalConverts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateLeftRightConverts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Public methodScale(Single) Obsolete. Scales the control and any child controls. (Inherited from Control.)
Public methodScale(SizeF)Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
Public methodScale(Single, Single) Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
Protected methodScaleControlScales a control's location, size, padding and margin. (Inherited from ListBox.)
Protected methodScaleCoreInfrastructure. This method is not relevant for this class. (Inherited from Control.)
Public methodSelect()Activates the control. (Inherited from Control.)
Protected methodSelect(Boolean, Boolean)Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control.)
Public methodSelectNextControlActivates the next control. (Inherited from Control.)
Public methodSendToBackSends the control to the back of the z-order. (Inherited from Control.)
Protected methodSetAutoSizeModeSets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32)Sets the bounds of the control to the specified location and size. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
Protected methodSetBoundsCoreInfrastructure. Sets the specified bounds of the ListBox control. (Inherited from ListBox.)
Protected methodSetClientSizeCoreSets the size of the client area of the control. (Inherited from Control.)
Public methodSetItemCheckedSets CheckState for the item at the specified index to Checked.
Public methodSetItemCheckStateSets the check state of the item at the specified index.
Protected methodSetItemCoreSets the object with the specified index in the derived class. (Inherited from ListBox.)
Protected methodSetItemsCoreClears the contents of the ListBox and adds the specified items to the control. (Inherited from ListBox.)
Public methodSetSelectedSelects or clears the selection for the specified item in a ListBox. (Inherited from ListBox.)
Protected methodSetStyleSets a specified ControlStyles flag to either true or false. (Inherited from Control.)
Protected methodSetTopLevelSets the control as the top-level control. (Inherited from Control.)
Protected methodSetVisibleCoreSets the control to the specified visible state. (Inherited from Control.)
Public methodShowDisplays the control to the user. (Inherited from Control.)
Protected methodSizeFromClientSizeDetermines the size of the entire control from the height and width of its client area. (Inherited from Control.)
Protected methodSortSorts the items in the ListBox. (Inherited from ListBox.)
Public methodSuspendLayoutTemporarily suspends the layout logic for the control. (Inherited from Control.)
Public methodToStringInfrastructure. Returns a string representation of the ListBox. (Inherited from ListBox.)
Public methodUpdateCauses the control to redraw the invalidated regions within its client area. (Inherited from Control.)
Protected methodUpdateBounds()Updates the bounds of the control with the current size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control.)
Protected methodUpdateStylesForces the assigned styles to be reapplied to the control. (Inherited from Control.)
Protected methodUpdateZOrderUpdates the control in its parent's z-order. (Inherited from Control.)
Protected methodWmReflectCommandProcesses the command message the CheckedListBox control receives from the top-level window. (Overrides ListBox.WmReflectCommand(Message).)
Protected methodWndProcProcesses Windows messages. (Overrides ListBox.WndProc(Message).)
Top

  NameDescription
Public eventAutoSizeChangedInfrastructure. This event is not relevant for this class. (Inherited from Control.)
Public eventBackColorChangedOccurs when the value of the BackColor property changes. (Inherited from Control.)
Public eventBackgroundImageChangedInfrastructure. Occurs when the BackgroundImage property of the label changes. (Inherited from ListBox.)
Public eventBackgroundImageLayoutChangedInfrastructure. Occurs when the BackgroundImageLayout property changes. (Inherited from ListBox.)
Public eventBindingContextChangedOccurs when the value of the BindingContext property changes. (Inherited from Control.)
Public eventCausesValidationChangedOccurs when the value of the CausesValidation property changes. (Inherited from Control.)
Public eventChangeUICuesOccurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.)
Public eventClickOccurs when the user clicks the CheckedListBox control.
Public eventClientSizeChangedOccurs when the value of the ClientSize property changes. (Inherited from Control.)
Public eventContextMenuChangedOccurs when the value of the ContextMenu property changes. (Inherited from Control.)
Public eventContextMenuStripChangedOccurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
Public eventControlAddedOccurs when a new control is added to the Control.ControlCollection. (Inherited from Control.)
Public eventControlRemovedOccurs when a control is removed from the Control.ControlCollection. (Inherited from Control.)
Public eventCursorChangedOccurs when the value of the Cursor property changes. (Inherited from Control.)
Public eventDataSourceChangedOccurs when the DataSource property changes.
Public eventDisplayMemberChangedOccurs when the DisplayMember property changes.
Public eventDisposedOccurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public eventDockChangedOccurs when the value of the Dock property changes. (Inherited from Control.)
Public eventDoubleClickOccurs when the control is double-clicked. (Inherited from Control.)
Public eventDragDropOccurs when a drag-and-drop operation is completed. (Inherited from Control.)
Public eventDragEnterOccurs when an object is dragged into the control's bounds. (Inherited from Control.)
Public eventDragLeaveOccurs when an object is dragged out of the control's bounds. (Inherited from Control.)
Public eventDragOverOccurs when an object is dragged over the control's bounds. (Inherited from Control.)
Public eventDrawItemInfrastructure. Occurs when a visual aspect of an owner-drawn CheckedListBox changes. This event is not relevant to this class.
Public eventEnabledChangedOccurs when the Enabled property value has changed. (Inherited from Control.)
Public eventEnterOccurs when the control is entered. (Inherited from Control.)
Public eventFontChangedOccurs when the Font property value changes. (Inherited from Control.)
Public eventForeColorChangedOccurs when the ForeColor property value changes. (Inherited from Control.)
Public eventFormatOccurs when the control is bound to a data value. (Inherited from ListControl.)
Public eventFormatInfoChangedOccurs when the value of the FormatInfo property changes. (Inherited from ListControl.)
Public eventFormatStringChangedOccurs when value of the FormatString property changes (Inherited from ListControl.)
Public eventFormattingEnabledChangedOccurs when the value of the FormattingEnabled property changes. (Inherited from ListControl.)
Public eventGiveFeedbackOccurs during a drag operation. (Inherited from Control.)
Public eventGotFocusOccurs when the control receives focus. (Inherited from Control.)
Public eventHandleCreatedOccurs when a handle is created for the control. (Inherited from Control.)
Public eventHandleDestroyedOccurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
Public eventHelpRequestedOccurs when the user requests help for a control. (Inherited from Control.)
Public eventImeModeChangedOccurs when the ImeMode property has changed. (Inherited from Control.)
Public eventInvalidatedOccurs when a control's display requires redrawing. (Inherited from Control.)
Public eventItemCheckOccurs when the checked state of an item changes.
Public eventKeyDownOccurs when a key is pressed while the control has focus. (Inherited from Control.)
Public eventKeyPressOccurs when a character. space or backspace key is pressed while the control has focus. (Inherited from Control.)
Public eventKeyUpOccurs when a key is released while the control has focus. (Inherited from Control.)
Public eventLayoutOccurs when a control should reposition its child controls. (Inherited from Control.)
Public eventLeaveOccurs when the input focus leaves the control. (Inherited from Control.)
Public eventLocationChangedOccurs when the Location property value has changed. (Inherited from Control.)
Public eventLostFocusOccurs when the control loses focus. (Inherited from Control.)
Public eventMarginChangedOccurs when the control's margin changes. (Inherited from Control.)
Public eventMeasureItemInfrastructure. Occurs when an owner-drawn ListBox is created and the sizes of the list items are determined. This event is not relevant to this class.
Public eventMouseCaptureChangedOccurs when the control loses mouse capture. (Inherited from Control.)
Public eventMouseClickOccurs when the user clicks the CheckedListBox control with the mouse.
Public eventMouseDoubleClickOccurs when the control is double clicked by the mouse. (Inherited from Control.)
Public eventMouseDownOccurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.)
Public eventMouseEnterOccurs when the mouse pointer enters the control. (Inherited from Control.)
Public eventMouseHoverOccurs when the mouse pointer rests on the control. (Inherited from Control.)
Public eventMouseLeaveOccurs when the mouse pointer leaves the control. (Inherited from Control.)
Public eventMouseMoveOccurs when the mouse pointer is moved over the control. (Inherited from Control.)
Public eventMouseUpOccurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.)
Public eventMouseWheelOccurs when the mouse wheel moves while the control has focus. (Inherited from Control.)
Public eventMoveOccurs when the control is moved. (Inherited from Control.)
Public eventPaddingChangedOccurs when the value of the Padding property changes. (Inherited from ListBox.)
Public eventPaintInfrastructure. Occurs when the ListBox control is painted. (Inherited from ListBox.)
Public eventParentChangedOccurs when the Parent property value changes. (Inherited from Control.)
Public eventPreviewKeyDownOccurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
Public eventQueryAccessibilityHelpOccurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.)
Public eventQueryContinueDragOccurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control.)
Public eventRegionChangedOccurs when the value of the Region property changes. (Inherited from Control.)
Public eventResizeOccurs when the control is resized. (Inherited from Control.)
Public eventRightToLeftChangedOccurs when the RightToLeft property value changes. (Inherited from Control.)
Public eventSelectedIndexChangedOccurs when the SelectedIndex property or the SelectedIndices collection has changed. (Inherited from ListBox.)
Public eventSelectedValueChangedOccurs when the SelectedValue property changes. (Inherited from ListControl.)
Public eventSizeChangedOccurs when the Size property value changes. (Inherited from Control.)
Public eventStyleChangedOccurs when the control style changes. (Inherited from Control.)
Public eventSystemColorsChangedOccurs when the system colors change. (Inherited from Control.)
Public eventTabIndexChangedOccurs when the TabIndex property value changes. (Inherited from Control.)
Public eventTabStopChangedOccurs when the TabStop property value changes. (Inherited from Control.)
Public eventTextChangedInfrastructure. Occurs when the Text property is changed. (Inherited from ListBox.)
Public eventValidatedOccurs when the control is finished validating. (Inherited from Control.)
Public eventValidatingOccurs when the control is validating. (Inherited from Control.)
Public eventValueMemberChangedOccurs when the ValueMember property changes.
Public eventVisibleChangedOccurs when the Visible property value changes. (Inherited from Control.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIDropTarget.OnDragDropInfrastructure. Raises the DragDrop event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragEnterInfrastructure. Raises the DragEnter event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragLeaveInfrastructure. Raises the DragLeave event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragOverInfrastructure. Raises the DragOver event. (Inherited from Control.)
Top

This control presents a list of items that the user can navigate by using the keyboard or the scrollbar on the right side of the control. The user can place a check mark by one or more items and the checked items can be navigated with the CheckedListBox.CheckedItemCollection and CheckedListBox.CheckedIndexCollection.

To add objects to the list at run time, assign an array of object references with the AddRange method. The list then displays the default string value for each object. You can add individual items to the list with the Add method.

The CheckedListBox object supports three states through the CheckState enumeration: Checked, Indeterminate, and Unchecked. You must set the state of Indeterminate in the code because the user interface for a CheckedListBox does not provide a mechanism to do so.

If UseTabStops is true, the CheckedListBox will recognize and expand tab characters in an item's text, creating columns. These tab stops are preset and cannot be changed. To use custom tab stops, set UseTabStops to false, set UseCustomTabOffsets to true, and add the custom values to the CustomTabOffsets collection.

NoteNote

If the UseCompatibleTextRendering property is false, the CustomTabOffsets property will be ignored and replaced with standard tab offsets.

The CheckedListBox class supports the following three indexed collections:

Collection

Encapsulating Class

All items contained in the CheckedListBox control.

CheckedListBox.ObjectCollection

Checked items (including items in an indeterminate state), which is a subset of the items contained in the CheckedListBox control.

CheckedListBox.CheckedItemCollection

Checked indexes, which is a subset of the indexes into the items collection. These indexes specify items in a checked or indeterminate state.

CheckedListBox.CheckedIndexCollection

The following three tables are examples of the three indexed collections that the CheckedListBox class supports.

The first table provides an example of the indexed collection of items in the control (all items contained in the control).

Index

Item

Check State

0

Object 1

Unchecked

1

Object 2

Checked

2

Object 3

Unchecked

3

Object 4

Indeterminate

4

Object 5

Checked

The second table provides an example of the indexed collection of the checked items.

Index

Item

0

Object 2

1

Object 4

2

Object 5

The third table provides an example of the indexed collection of indexes of checked items.

Index

Index of Item

0

1

1

3

2

4

The following example illustrates how you can use the methods, properties, and collections of a CheckedListBox. This is a complete sample ready to run once you have copied it to your project. You can check and uncheck items, use the text box to add items and once you have clicked the save button, clear the checked items.

namespace WindowsApplication1
{
   using System;
   using System.Drawing;
   using System.Collections;
   using System.ComponentModel;
   using System.Windows.Forms;
   using System.Data;
   using System.IO ;

   public class Form1 : System.Windows.Forms.Form
   {
      private System.Windows.Forms.CheckedListBox checkedListBox1;
      private System.Windows.Forms.TextBox textBox1;
      private System.Windows.Forms.Button button1;
      private System.Windows.Forms.Button button2;
      private System.Windows.Forms.ListBox listBox1;
      private System.Windows.Forms.Button button3;
        private System.ComponentModel.Container components;

      public Form1()
      {
            InitializeComponent();

         // Sets up the initial objects in the CheckedListBox. 
            string[] myFruit = {"Apples", "Oranges","Tomato"};
         checkedListBox1.Items.AddRange(myFruit);

            // Changes the selection mode from double-click to single click.
         checkedListBox1.CheckOnClick = true;
      }

      protected override void Dispose( bool disposing )
	  {
		if( disposing )
		{
			if (components != null) 
			{
			  components.Dispose();
			}
		}
		base.Dispose( disposing );
	  }

      private void InitializeComponent()
      {
         this.components = new System.ComponentModel.Container();
         this.textBox1 = new System.Windows.Forms.TextBox();
         this.checkedListBox1 = new System.Windows.Forms.CheckedListBox();
         this.listBox1 = new System.Windows.Forms.ListBox();
         this.button1 = new System.Windows.Forms.Button();
         this.button2 = new System.Windows.Forms.Button();
         this.button3 = new System.Windows.Forms.Button();
         this.textBox1.Location = new System.Drawing.Point(144, 64);
         this.textBox1.Size = new System.Drawing.Size(128, 20);
         this.textBox1.TabIndex = 1;
         this.textBox1.TextChanged += new System.EventHandler(this.textBox1_TextChanged);
         this.checkedListBox1.Location = new System.Drawing.Point(16, 64);
         this.checkedListBox1.Size = new System.Drawing.Size(120, 184);
         this.checkedListBox1.TabIndex = 0;
         this.checkedListBox1.ItemCheck += new System.Windows.Forms.ItemCheckEventHandler(this.checkedListBox1_ItemCheck);
         this.listBox1.Location = new System.Drawing.Point(408, 64);
         this.listBox1.Size = new System.Drawing.Size(128, 186);
         this.listBox1.TabIndex = 3;
         this.button1.Enabled = false;
         this.button1.Location = new System.Drawing.Point(144, 104);
         this.button1.Size = new System.Drawing.Size(104, 32);
         this.button1.TabIndex = 2;
         this.button1.Text = "Add Fruit";
         this.button1.Click += new System.EventHandler(this.button1_Click);
         this.button2.Enabled = false;
         this.button2.Location = new System.Drawing.Point(288, 64);
         this.button2.Size = new System.Drawing.Size(104, 32);
         this.button2.TabIndex = 2;
         this.button2.Text = "Show Order";
         this.button2.Click += new System.EventHandler(this.button2_Click);
         this.button3.Enabled = false;
         this.button3.Location = new System.Drawing.Point(288, 104);
         this.button3.Size = new System.Drawing.Size(104, 32);
         this.button3.TabIndex = 2;
         this.button3.Text = "Save Order";
         this.button3.Click += new System.EventHandler(this.button3_Click);
         this.ClientSize = new System.Drawing.Size(563, 273);
         this.Controls.AddRange(new System.Windows.Forms.Control[] {this.listBox1,
                                                        this.button3,
                                                        this.button2,
                                                        this.button1,
                                                        this.textBox1,
                                                        this.checkedListBox1});
         this.Text = "Fruit Order";
      }

      [STAThread]
      public static void Main(string[] args) 
      {
         Application.Run(new Form1());
      }

      // Adds the string if the text box has data in it. 
      private void button1_Click(object sender, System.EventArgs e)
      {
         if(textBox1.Text != "")
         {
            if(checkedListBox1.CheckedItems.Contains(textBox1.Text)== false)
               checkedListBox1.Items.Add(textBox1.Text,CheckState.Checked);
            textBox1.Text = "";
         }

      }
      // Activates or deactivates the Add button. 
      private void textBox1_TextChanged(object sender, System.EventArgs e)
      {
         if (textBox1.Text == "")
         {
            button1.Enabled = false;
         }
         else
         {
            button1.Enabled = true;
         }

        }

      // Moves the checked items from the CheckedListBox to the listBox. 
      private void button2_Click(object sender, System.EventArgs e)
      {
         listBox1.Items.Clear();
         button3.Enabled=false;
         for (int i=0; i< checkedListBox1.CheckedItems.Count;i++)
         {
            listBox1.Items.Add(checkedListBox1.CheckedItems[i]);
         }
         if (listBox1.Items.Count>0)
            button3.Enabled=true;

      }
        // Activates the move button if there are checked items. 
      private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e)
      {
         if(e.NewValue==CheckState.Unchecked)
         {
            if(checkedListBox1.CheckedItems.Count==1)
            {
               button2.Enabled = false;
            }
         }
         else
         {
            button2.Enabled = true;
         }
      }

        // Saves the items to a file. 
      private void button3_Click(object sender, System.EventArgs e)
      {   
         // Insert code to save a file.
         listBox1.Items.Clear();
         IEnumerator myEnumerator;
         myEnumerator = checkedListBox1.CheckedIndices.GetEnumerator();
         int y;
         while (myEnumerator.MoveNext() != false)
         {
            y =(int) myEnumerator.Current;
            checkedListBox1.SetItemChecked(y, false);
         }
         button3.Enabled = false ;
      }        
    }
}
   

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft