Class RadDropDownList

Represents a combo box class. The RadDropDownList class is essentially a simple wrapper for the RadDropDownListElement. The latter may be included in other telerik controls. All UI and logic functionality is implemented by the RadDropDownListElement class. RadDropDownList act to transfer event to and from its RadDropDownListElement instance.

Inheritance
System.Object
RadControl
RadEditorControl
RadDropDownList
RadCheckedDropDownList
RadDomainUpDown
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Data Controls")]
public class RadDropDownList : RadEditorControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, ISupportRootUIAutomation

Constructors

RadDropDownList()

Declaration
public RadDropDownList()

Fields

CreatingVisualListItemEventKey

Declaration
public static readonly object CreatingVisualListItemEventKey
Field Value
System.Object

KeyDownEventKey

Declaration
public static readonly object KeyDownEventKey
Field Value
System.Object

KeyPressEventKey

Declaration
public static readonly object KeyPressEventKey
Field Value
System.Object

KeyUpEventKey

Declaration
public static readonly object KeyUpEventKey
Field Value
System.Object

ListItemDataBindingEventKey

Declaration
public static readonly object ListItemDataBindingEventKey
Field Value
System.Object

ListItemDataBoundEventKey

Declaration
public static readonly object ListItemDataBoundEventKey
Field Value
System.Object

PopupClosedEventKey

Declaration
public static readonly object PopupClosedEventKey
Field Value
System.Object

PopupClosingEventKey

Declaration
public static readonly object PopupClosingEventKey
Field Value
System.Object

PopupOpenedEventKey

Declaration
public static readonly object PopupOpenedEventKey
Field Value
System.Object

PopupOpeningEventKey

Declaration
public static readonly object PopupOpeningEventKey
Field Value
System.Object

SelectedIndexChangedEventKey

Declaration
public static readonly object SelectedIndexChangedEventKey
Field Value
System.Object

SelectedIndexChangingEventKey

Declaration
public static readonly object SelectedIndexChangingEventKey
Field Value
System.Object

SelectedValueChangedEventKey

Declaration
public static readonly object SelectedValueChangedEventKey
Field Value
System.Object

SelectionRangeChangedKey

Declaration
public static readonly object SelectionRangeChangedKey
Field Value
System.Object

SortStyleChangedKey

Declaration
public static readonly object SortStyleChangedKey
Field Value
System.Object

VisualItemFormattingKey

Declaration
public static readonly object VisualItemFormattingKey
Field Value
System.Object

Properties

AllowShowFocusCues

Indicates focus cues display, when available, based on the corresponding control type and the current UI state.

Declaration
public override bool AllowShowFocusCues { get; set; }
Property Value
System.Boolean

Overrides

AutoCompleteDataSource

Gets or sets the object that is responsible for providing data objects for the AutoComplete Suggest.

Declaration
public virtual object AutoCompleteDataSource { get; set; }
Property Value
System.Object

AutoCompleteDisplayMember

Gets or sets a string which will be used to get a text string for each visual item. This value can not be set to null. Setting it to null will cause it to contain an empty string.

Declaration
[RadDescription("DisplayMember", typeof(RadListElement))]
public virtual string AutoCompleteDisplayMember { get; set; }
Property Value
System.String

AutoCompleteMode

Specifies the mode for the automatic completion feature used in the DropDownList and the TextBox controls.

Declaration
[RadDescription("AutoCompleteMode", typeof(RadDropDownListElement))]
public virtual AutoCompleteMode AutoCompleteMode { get; set; }
Property Value
System.Windows.Forms.AutoCompleteMode

AutoCompleteValueMember

Gets or sets the string through which the SelectedValue property will be determined. This property can not be set to null. Setting it to null will cause it to contain an empty string.

Declaration
[RadDescription("ValueMember", typeof(RadListElement))]
public virtual string AutoCompleteValueMember { get; set; }
Property Value
System.String

AutoSize

Gets or sets whether the edit control is auto-sized

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides

AutoSizeItems

Gets or sets a value that indicates whether items will be sized according to their content. If this property is true the user can set the Height property of each individual RadListDataItem in the Items collection in order to override the automatic sizing.

Declaration
public virtual bool AutoSizeItems { get; set; }
Property Value
System.Boolean

CaseSensitive

Gets or sets a value indicating whether string comparisons are case-sensitive.

Declaration
[RadDescription("CaseSensitive", typeof(RadDropDownListElement))]
public virtual bool CaseSensitive { get; set; }
Property Value
System.Boolean

CausesValidation

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

Declaration
public bool CausesValidation { get; set; }
Property Value
System.Boolean

true if the control causes validation to be performed on any controls requiring validation when it receives focus; otherwise, false.

DataMember

Declaration
public string DataMember { get; set; }
Property Value
System.String

DataSource

Gets or sets the object that is responsible for providing data objects for the RadListElement.

Declaration
[RadDefaultValue("DataSource", typeof(RadListElement))]
[RadDescription("DataSource", typeof(RadListElement))]
public object DataSource { get; set; }
Property Value
System.Object

DefaultItemsCountInDropDown

DefaultItems count in drop-down portion of the RadDropDownList.

Declaration
public virtual int DefaultItemsCountInDropDown { get; set; }
Property Value
System.Int32

DefaultSize

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

DescriptionTextMember

Gets or sets a property name which will be used to extract a text for description text from the data items. The value of the property with this name will be available via the Value property of every RadListDataItem in the Items collection.

Declaration
public string DescriptionTextMember { get; set; }
Property Value
System.String

DisplayMember

Gets or sets a string which will be used to get a text string for each visual item. This value can not be set to null. Setting it to null will cause it to contain an empty string.

Declaration
[RadDescription("DisplayMember", typeof(RadListElement))]
public string DisplayMember { get; set; }
Property Value
System.String

DropDownAnimationEasing

Gets or sets the easing type of the animation.

Declaration
public virtual RadEasingType DropDownAnimationEasing { get; set; }
Property Value
RadEasingType

DropDownAnimationEnabled

Gets or sets a value indicating whether the RadDropDownList will be animated when displaying.

Declaration
public virtual bool DropDownAnimationEnabled { get; set; }
Property Value
System.Boolean

DropDownAnimationFrames

Gets or sets the number of frames that will be used when the DropDown is being animated.

Declaration
public virtual int DropDownAnimationFrames { get; set; }
Property Value
System.Int32

DropDownHeight

Gets or sets the height in pixels of the drop-down portion of the RadDropDownList.

Declaration
[RadDescription("DropDownHeight", typeof(RadDropDownListElement))]
public virtual int DropDownHeight { get; set; }
Property Value
System.Int32

DropDownListElement

Represent the DropDownListElement element

Declaration
public virtual RadDropDownListElement DropDownListElement { get; }
Property Value
RadDropDownListElement

DropDownMaxSize

Declaration
[RadDefaultValue("DropDownMaxSize", typeof(RadDropDownListElement))]
public virtual Size DropDownMaxSize { get; set; }
Property Value
System.Drawing.Size

DropDownMinSize

Declaration
public virtual Size DropDownMinSize { get; set; }
Property Value
System.Drawing.Size

DropDownSizingMode

Gets or sets a value of the SizingMode enumeration. This value determines how the pop-up form can be resized: vertically, horizontally or both.

Declaration
public virtual SizingMode DropDownSizingMode { get; set; }
Property Value
SizingMode

DropDownStyle

Gets or sets a value specifying the style of the DropDownList

Declaration
[RadPropertyDefaultValue("DropDownStyle", typeof(RadDropDownListElement))]
public virtual RadDropDownStyle DropDownStyle { get; set; }
Property Value
RadDropDownStyle

EnableAlternatingItemColor

Gets or sets a value indicating whether alternating item color is enabled.

Declaration
public virtual bool EnableAlternatingItemColor { get; set; }
Property Value
System.Boolean

EnableKineticScrolling

Gets or sets a value indicating whether the kinetic scrolling function is enabled.

Declaration
public virtual bool EnableKineticScrolling { get; set; }
Property Value
System.Boolean

EnableMouseWheel

Enable or disable Mouse Wheel Scrolling.

Declaration
public bool EnableMouseWheel { get; set; }
Property Value
System.Boolean

EnableUIAutomation

Declaration
public virtual bool EnableUIAutomation { get; set; }
Property Value
System.Boolean

Implements

Filter

Gets or sets a predicate which filters which items can be visible.

Declaration
public Predicate<RadListDataItem> Filter { get; set; }
Property Value
System.Predicate<RadListDataItem>

FilterExpression

Gets or sets a filter expression which determines which items will be visible.

Declaration
public string FilterExpression { get; set; }
Property Value
System.String

FindStringComparer

Gets or sets an object that implements IFindStringComparer. The value of this property is used in the FindString() method when searching for an item.

Declaration
public IFindStringComparer FindStringComparer { get; set; }
Property Value
IFindStringComparer

FitItemsToSize

Declaration
public virtual bool FitItemsToSize { get; set; }
Property Value
System.Boolean

Font

Gets or sets the Font of the control. This actually is the Font property of the root element. Setting to [null] resets the value and the font from the applied theme will be used.

Declaration
public override Font Font { get; set; }
Property Value
System.Drawing.Font

Overrides

FormatInfo

Gets or sets an object that implements the IFormatProvider interface. This object is used when formatting items. The default object is CultureInfo.CurrentCulture.

Declaration
public virtual IFormatProvider FormatInfo { get; set; }
Property Value
System.IFormatProvider

FormatString

Gets or sets a format string that will be used for visual item formatting if FormattingEnabled is set to true.

Declaration
public virtual string FormatString { get; set; }
Property Value
System.String

FormattingEnabled

Gets or sets a value that determines whether text formatting is enabled for the visual items.

Declaration
[RadDescription("FormattingEnabled", typeof(RadDropDownListElement))]
public virtual bool FormattingEnabled { get; set; }
Property Value
System.Boolean

IsFilterActive

Gets a value indicating whether there is a Filter or FilterExpression set.

Declaration
public bool IsFilterActive { get; }
Property Value
System.Boolean

IsPopupVisible

Indicating whether the Popup part of the control are displayed.

Declaration
public virtual bool IsPopupVisible { get; }
Property Value
System.Boolean

ItemHeight

Gets or sets the item height for the items in the pop-up. This property is disregarded when AutoSizeItems is set to true.

Declaration
public int ItemHeight { get; set; }
Property Value
System.Int32

Items

Declaration
public virtual RadListDataItemCollection Items { get; }
Property Value
RadListDataItemCollection

ItemsSortComparer

Gets or sets an object that implements IComparer which is used when sorting items.

Declaration
public IComparer<RadListDataItem> ItemsSortComparer { get; set; }
Property Value
System.Collections.Generic.IComparer<RadListDataItem>

ListElement

Represent the List element

Declaration
public RadListElement ListElement { get; set; }
Property Value
RadListElement

MaxDropDownItems

Gets or sets the maximum number of items to be shown in the drop-down portion of the RadDropDownList.

Declaration
public virtual int MaxDropDownItems { get; set; }
Property Value
System.Int32

MaxLength

Gets or sets the maximum number of characters the user can type or paste into the text box control.

Declaration
public virtual int MaxLength { get; set; }
Property Value
System.Int32

NullText

Gets or sets the text that is displayed when RadDropDownList has no text set.

Declaration
[RadDefaultValue("NullText", typeof(RadTextBoxItem))]
[RadDescription("NullText", typeof(RadTextBoxItem))]
public string NullText { get; set; }
Property Value
System.String

Popup

Gets a reference to the drop down form associated with this RadDropDownList.

Declaration
public virtual RadEditorPopupControlBase Popup { get; }
Property Value
RadEditorPopupControlBase

ReadOnly

Gets or sets a value indicating whether the drop down list is read only.

Declaration
public virtual bool ReadOnly { get; set; }
Property Value
System.Boolean

true if the drop down list is read only; otherwise, false.

SelectedIndex

Gets or sets the position of the selection. Setting this property will cause the SelectedIndexChanging and SelectedIndexChanged events to fire.

Declaration
public virtual int SelectedIndex { get; set; }
Property Value
System.Int32

SelectedItem

Gets or sets the selected logical list item. Setting this property will cause the selection events to fire.

Declaration
public virtual RadListDataItem SelectedItem { get; set; }
Property Value
RadListDataItem

SelectedItems

Provides a read-only interface to the currently selected items.

Declaration
public IReadOnlyCollection<RadListDataItem> SelectedItems { get; }
Property Value
IReadOnlyCollection<RadListDataItem>

SelectedText

Gets or sets the text that is selected in the editable portion of the DropDownList.

Declaration
public string SelectedText { get; set; }
Property Value
System.String

SelectedValue

Gets or sets the currently selected value. Setting the SelectedValue to a value that is shared between many items causes the first item to be selected. This property triggers the selection events.

Declaration
public virtual object SelectedValue { get; set; }
Property Value
System.Object

SelectionLength

Gets or sets the number of characters selected in the editable portion of the combo box.

Declaration
public int SelectionLength { get; set; }
Property Value
System.Int32

SelectionStart

Gets or sets the starting index of text selected in the combo box.

Declaration
public int SelectionStart { get; set; }
Property Value
System.Int32

SelectNextOnDoubleClick

Rotate items on double click in the edit box part

Declaration
[RadDescription("SelectNextOnDoubleClick", typeof(RadDropDownListElement))]
public virtual bool SelectNextOnDoubleClick { get; set; }
Property Value
System.Boolean

ShowImageInEditorArea

Gets or sets that RadListDataItem Image will be displayed in Editor Element when DropDownStyle is set to DropDownStyleList

Declaration
public virtual bool ShowImageInEditorArea { get; set; }
Property Value
System.Boolean

SortStyle

Gets or sets the sort style. It can be Ascending, Descending or None. Sorting is performed according to the property specified by DisplayMember.

Declaration
public virtual SortStyle SortStyle { get; set; }
Property Value
SortStyle

TabStop

Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.

Declaration
public bool TabStop { get; set; }
Property Value
System.Boolean

true if the user can give the focus to the control using the TAB key;otherwise, false. The default is true.

Text

Declaration
public override string Text { get; set; }
Property Value
System.String

Overrides

UIAutomationProvider

Declaration
public IRadRawElementProviderFragmentRoot UIAutomationProvider { get; }
Property Value
IRadRawElementProviderFragmentRoot

Implements

ValueMember

Gets or sets the string through which the SelectedValue property will be determined. This property can not be set to null. Setting it to null will cause it to contain an empty string.

Declaration
[RadDescription("ValueMember", typeof(RadListElement))]
public string ValueMember { get; set; }
Property Value
System.String

Methods

BeginUpdate()

Call BeginUpdate at the beginning of a block that makes many modifications in the GUI EndUpdate()

Declaration
public virtual void BeginUpdate()

CloseDropDown()

HIde the pop-up from the screen.

Declaration
public virtual void CloseDropDown()

ControlDefinesThemeForElement(RadElement)

Declaration
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Overrides

CreateAccessibilityInstance()

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

CreateChildItems(RadElement)

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

Overrides

CreateDropDownListElement()

Declaration
protected virtual RadDropDownListElement CreateDropDownListElement()
Returns
RadDropDownListElement

CreateRootElement()

Declaration
protected override RootRadElement CreateRootElement()
Returns
RootRadElement

Overrides

DeferRefresh()

Defers the refresh.

Declaration
public virtual IDisposable DeferRefresh()
Returns
System.IDisposable

Dispose(Boolean)

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

Overrides

dropDownListElement_KeyDown(Object, KeyEventArgs)

Declaration
protected virtual void dropDownListElement_KeyDown(object sender, KeyEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyEventArgs e

dropDownListElement_KeyPress(Object, KeyPressEventArgs)

Declaration
protected virtual void dropDownListElement_KeyPress(object sender, KeyPressEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyPressEventArgs e

dropDownListElement_KeyUp(Object, KeyEventArgs)

Declaration
protected virtual void dropDownListElement_KeyUp(object sender, KeyEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyEventArgs e

element_PopupClosed(Object, RadPopupClosedEventArgs)

Declaration
protected virtual void element_PopupClosed(object sender, RadPopupClosedEventArgs args)
Parameters
System.Object sender

RadPopupClosedEventArgs args

element_PopupClosing(Object, RadPopupClosingEventArgs)

Declaration
protected virtual void element_PopupClosing(object sender, RadPopupClosingEventArgs args)
Parameters
System.Object sender

RadPopupClosingEventArgs args

element_PopupOpened(Object, EventArgs)

Declaration
protected virtual void element_PopupOpened(object sender, EventArgs e)
Parameters
System.Object sender

System.EventArgs e

element_PopupOpening(Object, CancelEventArgs)

Declaration
protected virtual void element_PopupOpening(object sender, CancelEventArgs e)
Parameters
System.Object sender

System.ComponentModel.CancelEventArgs e

EndInit()

Resumes layout.

Declaration
public override void EndInit()
Overrides

EndUpdate()

Call EndUpdate at the end of a block that makes many modifications in the GUI BeginUpdate()

Declaration
public virtual void EndUpdate()

FindItemExact(String, Boolean)

Declaration
public RadListDataItem FindItemExact(string text, bool caseSensitive)
Parameters
System.String text

System.Boolean caseSensitive

Returns
RadListDataItem

FindString(String)

Searches for an item related to the specified string. The relation is described by the object assigned to FindStringComparer property. By default FindStringComparer uses the System.String.StartsWith() method. This method starts searching from zero based index. If the algorithm reaches the end of the Items collection it wraps to the beginning and continues until one before the provided index.

Declaration
public int FindString(string s)
Parameters
System.String s

The string with which every item will be compared.
Returns
System.Int32

The index of the found item or -1 if no item is found.

FindString(String, Int32)

Searches for an item related to the specified string. The relation is described by the object assigned to FindStringComparer property. By default FindStringComparer uses the System.String.StartsWith() method. This method starts searching from the specified index. If the algorithm reaches the end of the Items collection it wraps to the beginning and continues until one before the provided index.

Declaration
public int FindString(string s, int startIndex)
Parameters
System.String s

The string with which every item will be compared.
System.Int32 startIndex

The index from which to start searching.
Returns
System.Int32

The index of the found item or -1 if no item is found.

FindStringExact(String)

Searches for an item in the same manner as FindString() but matches an item only if its text is exactly equal to the provided string.

Declaration
public int FindStringExact(string s)
Parameters
System.String s

Returns
System.Int32

FindStringExact(String, Int32)

Searches for an item in the same manner as FindString() but matches an item only if its text is exactly equal to the provided string.

Declaration
public int FindStringExact(string s, int startIndex)
Parameters
System.String s

System.Int32 startIndex

Returns
System.Int32

FindStringNonWrapping(String)

Searches for an item in the same manner as FindString() but does not start from the beginning when the end of the Items collection is reached.

Declaration
public int FindStringNonWrapping(string s)
Parameters
System.String s

The string that will be used to search for an item.
Returns
System.Int32

The index of the found item or -1 if no item is found.

FindStringNonWrapping(String, Int32)

Searches for an item in the same manner as FindString() but does not start from the beginning when the end of the Items collection is reached.

Declaration
public int FindStringNonWrapping(string s, int startIndex)
Parameters
System.String s

The string that will be used to search for an item.
System.Int32 startIndex

The index from which to start searching.
Returns
System.Int32

The index of the found item or -1 if no item is found.

IsInputChar(Char)

Declaration
protected override bool IsInputChar(char charCode)
Parameters
System.Char charCode

Returns
System.Boolean

IsInputKey(Keys)

Declaration
protected override bool IsInputKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

Overrides

OnBindingContextChanged(EventArgs)

Declaration
protected override void OnBindingContextChanged(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnCreatingVisualItem(Object, CreatingVisualListItemEventArgs)

Declaration
protected virtual void OnCreatingVisualItem(object sender, CreatingVisualListItemEventArgs args)
Parameters
System.Object sender

CreatingVisualListItemEventArgs args

OnDataBindingComplete(Object, ListBindingCompleteEventArgs)

Raises the DataBindingComplete event.

Declaration
protected virtual void OnDataBindingComplete(object sender, ListBindingCompleteEventArgs e)
Parameters
System.Object sender

ListBindingCompleteEventArgs e

An ListBindingCompleteEventArgs instance that contains the event data.
See Also

OnEnter(EventArgs)

Declaration
protected override void OnEnter(EventArgs e)
Parameters
System.EventArgs e

OnGotFocus(EventArgs)

Declaration
protected override void OnGotFocus(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnItemDataBinding(Object, ListItemDataBindingEventArgs)

Declaration
protected virtual void OnItemDataBinding(object sender, ListItemDataBindingEventArgs args)
Parameters
System.Object sender

ListItemDataBindingEventArgs args

OnItemDataBound(Object, ListItemDataBoundEventArgs)

Declaration
protected virtual void OnItemDataBound(object sender, ListItemDataBoundEventArgs args)
Parameters
System.Object sender

ListItemDataBoundEventArgs args

OnLeave(EventArgs)

Declaration
protected override void OnLeave(EventArgs e)
Parameters
System.EventArgs e

OnLostFocus(EventArgs)

Declaration
protected override void OnLostFocus(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnRightToLeftChanged(EventArgs)

Declaration
protected override void OnRightToLeftChanged(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnSelectedIndexChanged(Object, Int32)

Declaration
protected virtual void OnSelectedIndexChanged(object sender, int newIndex)
Parameters
System.Object sender

System.Int32 newIndex

OnSelectedIndexChanging(Object, Int32)

Declaration
protected virtual bool OnSelectedIndexChanging(object sender, int newIndex)
Parameters
System.Object sender

System.Int32 newIndex

Returns
System.Boolean

OnSelectedValueChanged(Object, Int32, Object, Object)

Declaration
protected virtual void OnSelectedValueChanged(object sender, int newIndex, object oldValue, object newValue)
Parameters
System.Object sender

System.Int32 newIndex

System.Object oldValue

System.Object newValue

OnSortStyleChanged(SortStyle)

Declaration
protected virtual void OnSortStyleChanged(SortStyle sortStyle)
Parameters
SortStyle sortStyle

OnVisualItemFormatting(RadListVisualItem)

Declaration
protected virtual void OnVisualItemFormatting(RadListVisualItem item)
Parameters
RadListVisualItem item

ProcessAutoSizeChanged(Boolean)

Declaration
protected override void ProcessAutoSizeChanged(bool value)
Parameters
System.Boolean value

Overrides

ProcessCodedUIMessage(ref IPCMessage)

Declaration
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters
IPCMessage request

Overrides

Rebind()

Forces re-evaluation of the current data source (if any).

Declaration
public void Rebind()

ResetBackColorThemeOverrides()

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetForeColorThemeOverrides()

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

SelectAll()

Selects all items if the SelectionMode allows it.

Declaration
public void SelectAll()
Exceptions
System.InvalidOperationException

Selecting all items is not a valid operation in the current selection mode. SelectionMode = + this.selectionMode.ToString() + .

SelectAllText()

Selects all the text in the editable portion of the DropDownList box.

Declaration
public void SelectAllText()

SelectText(Int32, Int32)

Selects a range of text in the editable portion of the combo box

Declaration
public void SelectText(int start, int length)
Parameters
System.Int32 start

The position of the first character in the current text selection within the text box.
System.Int32 length

The number of characters to select.

SetBackColorThemeOverrides()

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

ShowDropDown()

Displays the pop-up on the screen.

Declaration
public virtual void ShowDropDown()

WndProc(ref Message)

Declaration
protected override void WndProc(ref Message m)
Parameters
System.Windows.Forms.Message m

Overrides

Events

CreatingVisualListItem

This event allows the user to create custom visual items. It is fired initially for all the visible items and when the control is resized afterwards.

Declaration
public event CreatingVisualListItemEventHandler CreatingVisualListItem
Event Type
CreatingVisualListItemEventHandler

DataBindingComplete

Fires after data binding operation has finished.

Declaration
public event ListBindingCompleteEventHandler DataBindingComplete
Event Type
ListBindingCompleteEventHandler

See Also

ItemDataBinding

This event fires before a RadListDataItem is data bound. This happens when the DataSource property is assigned and the event fires for every item provided by the data source. This event allows a custom RadListDataItem to be provided by the user.

Declaration
public event ListItemDataBindingEventHandler ItemDataBinding
Event Type
ListItemDataBindingEventHandler

ItemDataBound

This event fires after a RadListDataItem is data bound. This happens when the DataSource property is assigned and the event is fired for every item provided by the data source.

Declaration
public event ListItemDataBoundEventHandler ItemDataBound
Event Type
ListItemDataBoundEventHandler

KeyDown

Occurs when a key is pressed while the control has focus.

Declaration
public event KeyEventHandler KeyDown
Event Type
System.Windows.Forms.KeyEventHandler

KeyPress

Occurs when a key is pressed while the control has focus.

Declaration
public event KeyPressEventHandler KeyPress
Event Type
System.Windows.Forms.KeyPressEventHandler

KeyUp

Occurs when a key is released while the control has focus.

Declaration
public event KeyEventHandler KeyUp
Event Type
System.Windows.Forms.KeyEventHandler

PopupClosed

Fires when the pop-up is closed.

Declaration
public virtual event RadPopupClosedEventHandler PopupClosed
Event Type
RadPopupClosedEventHandler

PopupClosing

Fires when the pop-up is about to be closed.

Declaration
public virtual event RadPopupClosingEventHandler PopupClosing
Event Type
RadPopupClosingEventHandler

PopupOpened

Fires when the pop-up form is opened.

Declaration
public virtual event EventHandler PopupOpened
Event Type
System.EventHandler

PopupOpening

Fires when the pop-up form is about to be opened.

Declaration
public virtual event CancelEventHandler PopupOpening
Event Type
System.ComponentModel.CancelEventHandler

SelectedIndexChanged

This event fires when the selected index property changes.

Declaration
public event PositionChangedEventHandler SelectedIndexChanged
Event Type
PositionChangedEventHandler

SelectedIndexChanging

This event fires before SelectedIndex changes. This event allows the operation to be cancelled.

Declaration
public event PositionChangingEventHandler SelectedIndexChanging
Event Type
PositionChangingEventHandler

SelectedValueChanged

This event fires only if the SelectedValue has really changed. For example it will not fire if the previously selected item has the same value as the newly selected item.

Declaration
public event EventHandler SelectedValueChanged
Event Type
System.EventHandler

SortStyleChanged

This event fires when the SortStyle property changes.

Declaration
public event SortStyleChangedEventHandler SortStyleChanged
Event Type
SortStyleChangedEventHandler

TextChanged

Occurs when the Text property value changes.

Declaration
public event EventHandler TextChanged
Event Type
System.EventHandler

VisualListItemFormatting

The VisualItemFormatting event fires whenever a property of a visible data item changes and whenever a visual item is associated with a new data item. During scrolling for example.

Declaration
public event VisualListItemFormattingEventHandler VisualListItemFormatting
Event Type
VisualListItemFormattingEventHandler

Explicit Interface Implementations

ISupportRootUIAutomation.InitializeUIAutomationProvider()

Declaration
void ISupportRootUIAutomation.InitializeUIAutomationProvider()
Implements

ISupportRootUIAutomation.RootUIAutomationManager

Gets the UI Automation Manager.

Declaration
IRootUIAutomationManager ISupportRootUIAutomation.RootUIAutomationManager { get; }
Returns
IRootUIAutomationManager

Implements

Extension Methods