Represents a CheckedDropDown List control that allows multiple item selection through checkboxes. The RadCheckedDropDownList class is a specialized version of RadDropDownList that wraps the RadCheckedDropDownListElement. This control provides functionality for displaying a list of items with checkboxes that can be individually selected.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Data Controls")]
[ComplexBindingProperties("DataSource", "ValueMember")]
[LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "SelectedValue")]
[DefaultBindingProperty("Text")]
public class RadCheckedDropDownList : RadDropDownList, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportRootUIAutomationInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadDropDownListRadCheckedDropDownList...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadCheckedDropDownList class with default settings. Sets the dropdown style to DropDownList and enables tab navigation.
public RadCheckedDropDownList()Properties
Gets or sets the mode for the automatic completion feature used in the checked dropdown list. This determines how the control suggests completions as the user types.
[Browsable(true)]
public override AutoCompleteMode AutoCompleteMode { get; set; }Overrides:
Gets the RadAutoCompleteBoxElement associated with this control. This element provides the auto-complete text box functionality.
protected RadAutoCompleteBoxElement AutoCompleteTextBoxElement { get; }Gets the instance of RadCheckedDropDownListElement that provides the core functionality for this control.
[Browsable(false)]
public RadCheckedDropDownListElement CheckedDropDownListElement { get; set; }Gets a collection of items that are currently checked in this RadCheckedDropDownList. This collection only contains the items that have been selected by the user.
public DropDownCheckedItemsCollection CheckedItems { get; }Gets or sets the name of the property in the data source that determines the checked state of items. When binding to a data source, this property specifies which field should be used to determine if an item is checked or unchecked.
public string CheckedMember { get; set; }Gets a collection of items contained in this RadCheckedDropDownList. This collection includes all items that can be checked or unchecked in the list.
public RadCheckedListDataItemCollection Items { get; }Gets or sets the maximum number of characters the user can type or paste into the text box control. The default value is the maximum possible integer (2,147,483,647).
public override int MaxLength { get; set; }Overrides:
Gets or sets a value indicating whether the hosted textbox supports multiple lines of text. When set to true, the textbox can display multiple lines and accept line breaks.
[Browsable(true)]
public bool Multiline { get; set; }Gets or sets a value indicating whether the dropdown list is read-only. When set to true, users cannot modify the text in the textbox, but can still check/uncheck items.
[Browsable(true)]
public override bool ReadOnly { get; set; }Overrides:
Gets or sets a value indicating whether to display a "Check All" item in the dropdown list. When enabled, this adds an item at the top of the list that allows users to check or uncheck all items at once.
[Browsable(true)]
public bool ShowCheckAllItems { get; set; }Gets or sets a value indicating whether the checked state of items is synchronized with the text in the editable area. When true, the text displayed in the textbox reflects the checked items in the dropdown list.
[Browsable(true)]
public bool SyncSelectionWithText { get; set; }Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.
[Browsable(true)]
public bool TabStop { get; set; }Gets the name of the theme class used for styling this control.
public override string ThemeClassName { get; }The fully qualified name of the RadDropDownList type.
Overrides:
Methods
Begins the initialization of the RadCheckedDropDownList control.
public override void BeginInit()Overrides:
Determines whether an element can be edited at design time.
protected override bool CanEditElementAtDesignTime(RadElement element)The RadElement to check.
Returns:true if the element can be edited at design time; otherwise, false.
Overrides:
Creates the RadCheckedDropDownListElement that is wrapped by this control.
protected override RadDropDownListElement CreateDropDownListElement()A new instance of RadCheckedDropDownListElement.
Overrides:
Ends the initialization of the RadCheckedDropDownList control.
public override void EndInit()Overrides:
Resets theme overrides for the BackColor property to their default values.
protected override void ResetBackColorThemeOverrides()Overrides:
Resets theme overrides for the ForeColor property to their default values.
protected override void ResetForeColorThemeOverrides()Overrides:
Sets theme overrides for the BackColor property across all visual elements of the control.
protected override void SetBackColorThemeOverrides()Overrides:
Sets theme overrides for the ForeColor property across all visual elements of the control.
protected override void SetForeColorThemeOverrides()Overrides:
Events
Occurs when the "Check All" item has its checked state changed. This event is raised after the state has been changed and all items have been affected.
public event RadCheckedListDataItemEventHandler CheckAllItemCheckedChangedOccurs when the "Check All" item is about to have its checked state changed. This event can be canceled to prevent the state change, which would otherwise affect all items in the list.
public event RadCheckedListDataItemCancelEventHandler CheckAllItemCheckedChangingOccurs when an instance of ITextBlock is being created. This event allows customization of text blocks during their creation.
public event CreateTextBlockEventHandler CreateTextBlockOccurs when a ListViewDataItem has its checked state changed. This event is raised after the item's checked state has been modified.
public event RadCheckedListDataItemEventHandler ItemCheckedChangedOccurs when a ListViewDataItem is about to have its checked state changed. This event can be canceled to prevent the state change.
public event RadCheckedListDataItemCancelEventHandler ItemCheckedChangingOccurs when a text block is formatting. This event allows customization of how text blocks are displayed in the control.
public event TextBlockFormattingEventHandler TextBlockFormattingOccurs when text is being validated as a token. This event allows custom validation of text before it becomes a token.
public event TokenValidatingEventHandler TokenValidating