New to Telerik UI for WinForms? Download free 30-day trial

Properties

Property Description
EnableAlternatingItemColor Gets or sets a value indicating whether alternating item color is enabled.
AllowShowFocusCues Indicates focus cues display, when available, based on the corresponding control type and the current UI state.
EnableKineticScrolling Gets or sets a value indicating whether the kinetic scrolling function is enabled.
ShowImageInEditorArea Gets or sets that RadListDataItem Image will be displayd in Editor Element when DropDownStyle is set to DropDownStyleList.
FitItemsToSize Gets or sets whether the RadListDataItem will fit to the available size.
Popup Gets a reference to the drop down form associated with this RadDropDownList.
MaxDropDownItems Gets or sets the maximum number of items to be shown in the drop-down portion of the RadDropDownList.
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.
MaxLength Gets or sets the maximum number of characters the user can type or paste into the text box control.
DropDownMinSize Gets or sets the drop down minimal size.
DropDownSizingMode Gets or sets the drop down sizing mode. The mode can be: horizontal, vertical or a combination of them.
CaseSensitive Gets or sets a value indicating whether string comparisons are case-sensitive.
AutoCompleteMode Specifies the mode for the automatic completion feature used in the DropDownList and the TextBox controls.
SelectNextOnDoubleClick Rotate items on double click in the edit box part.
FormatInfo Gets or sets an object that implements the IFormatProvider interface. This object is used when formatting items. The default object is CultureInfo.CurrentCulture.
FormatString Gets or sets a format string that will be used for visual item formatting if FormattingEnabled is set to true.
SortStyle Gets or sets the sort style. It can be Ascending, Descending or None. Sorting is performed according to the property specified by DisplayMember.
FormattingEnabled Gets or sets a value that determines whether text formatting is enabled for the visual items.
DropDownAnimationEasing Gets or sets the easing type of the animation.
DropDownAnimationEnabled Gets or sets a value indicating whether the RadDropDownList will be animated when displaying.
DropDownAnimationFrames Gets or sets the number of frames that will be used when the DropDown is being animated.
DropDownHeight Gets or sets the height in pixels of the drop-down portion of the RadDropDownList.
DropDownStyle Gets or sets a value specifying the style of the RadDropDownList.
DefaultItemsCountInDropDown DefaultItems count in drop-down portion of the RadDropDownList.
DropDownMaxSize Gets or sets the drop down maximal size.
DropDownListElement Represents the DropDownListElement element.
ListElement Represents the List element.
Items Gets a collection representing the items contained in this RadDropDownList.
SelectedItems Provides a readonly interface to the currently selected items.
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.
SelectedItem Gets or sets the selected logical list item. Setting this property will cause the selection events to fire.
SelectedIndex Gets or sets the position of the selection.Setting this property will cause the SelectedIndexChanging and SelectedIndexChanged events to fire.
AutoCompleteDataSource Gets or sets the object that is responsible for providing data objects for the AutoComplete suggest.
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.
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.
DataSource Gets or sets the object that is responsible for providing data objects for the RadListElement.
DataMember Gets or sets the name of the list or table in the data source for which the RadListControl is displaying data.
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.
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.
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.
EnableMouseWheel Indicates whether users can change the selected item by the mouse wheel.
IsPopupVisible Indicating whether the Popup part of the control are displayed.
Filter Gets or sets a predicate which filters which items can be visible.
FilterExpression Gets or sets a filter expression which determines which items will be visible.
IsFilterActive Gets a value indicating whether there is a Filter or FilterExpression set.
ReadOnly Gets or sets a value indicating whether the drop down list is read only.

Methods

Method Description
FindItemExact Returns the RadListDataItem by a given text.
FindString 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.
FindStringExact 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.
FindStringNonWrapping 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.
Rebind Forces re-evaluation of the current data source (if any).
ShowDropDown Displays the pop-up on the screen.
CloseDropDown Hides the popup from the screen.
BeginUpdate Calls BeginUpdate at the beginning of a block that makes many modifications in the GUI
EndUpdate Calls EndUpdate at the end of a block that makes many modifications in the GUI

Events

Event Description
DataBindingComplete Fires after data binding operation has finished.
PopupOpening Fires when the pop-up form is about to be opened.
PopupOpened Fires when the pop-up form is opened.
PopupClosing Fires when the pop-up is about to be closed.
PopupClosed Fires when the pop-up is closed.
SelectedIndexChanged This event fires when the selected index property changes.
SelectedIndexChanging This event fires before SelectedIndex changes. This event allows the operation to be canceled.
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.
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.
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.
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.
SortStyleChanged This event fires when the SortStyle property changes.
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.

See Also

In this article