New to Telerik UI for WinFormsStart a free 30-day trial

Properties

Updated over 6 months ago
PropertyDescription
EnableAlternatingItemColorGets or sets a value indicating whether alternating item color is enabled.
AllowShowFocusCuesIndicates focus cues display, when available, based on the corresponding control type and the current UI state.
EnableKineticScrollingGets or sets a value indicating whether the kinetic scrolling function is enabled.
ShowImageInEditorAreaGets or sets that RadListDataItem Image will be displayd in Editor Element when DropDownStyle is set to DropDownStyleList.
FitItemsToSizeGets or sets whether the RadListDataItem will fit to the available size.
PopupGets a reference to the drop down form associated with this RadDropDownList.
MaxDropDownItemsGets or sets the maximum number of items to be shown in the drop-down portion of the RadDropDownList.
AutoSizeItemsGets 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.
MaxLengthGets or sets the maximum number of characters the user can type or paste into the text box control.
DropDownMinSizeGets or sets the drop down minimal size.
DropDownSizingModeGets or sets the drop down sizing mode. The mode can be: horizontal, vertical or a combination of them.
CaseSensitiveGets or sets a value indicating whether string comparisons are case-sensitive.
AutoCompleteModeSpecifies the mode for the automatic completion feature used in the DropDownList and the TextBox controls.
SelectNextOnDoubleClickRotate items on double click in the edit box part.
FormatInfoGets or sets an object that implements the IFormatProvider interface. This object is used when formatting items. The default object is CultureInfo.CurrentCulture.
FormatStringGets or sets a format string that will be used for visual item formatting if FormattingEnabled is set to true.
SortStyleGets or sets the sort style. It can be Ascending, Descending or None. Sorting is performed according to the property specified by DisplayMember.
FormattingEnabledGets or sets a value that determines whether text formatting is enabled for the visual items.
DropDownAnimationEasingGets or sets the easing type of the animation.
DropDownAnimationEnabledGets or sets a value indicating whether the RadDropDownList will be animated when displaying.
DropDownAnimationFramesGets or sets the number of frames that will be used when the DropDown is being animated.
DropDownHeightGets or sets the height in pixels of the drop-down portion of the RadDropDownList.
DropDownStyleGets or sets a value specifying the style of the RadDropDownList.
DefaultItemsCountInDropDownDefaultItems count in drop-down portion of the RadDropDownList.
DropDownMaxSizeGets or sets the drop down maximal size.
DropDownListElementRepresents the DropDownListElement element.
ListElementRepresents the List element.
ItemsGets a collection representing the items contained in this RadDropDownList.
SelectedItemsProvides a readonly interface to the currently selected items.
SelectedValueGets 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.
SelectedItemGets or sets the selected logical list item. Setting this property will cause the selection events to fire.
SelectedIndexGets or sets the position of the selection.Setting this property will cause the SelectedIndexChanging and SelectedIndexChanged events to fire.
AutoCompleteDataSourceGets or sets the object that is responsible for providing data objects for the AutoComplete suggest.
AutoCompleteDisplayMemberGets 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.
AutoCompleteValueMemberGets 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.
DataSourceGets or sets the object that is responsible for providing data objects for the RadListElement.
DataMemberGets or sets the name of the list or table in the data source for which the RadListControl is displaying data.
DisplayMemberGets 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.
ValueMemberGets 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.
DescriptionTextMemberGets 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.
EnableMouseWheelIndicates whether users can change the selected item by the mouse wheel.
IsPopupVisibleIndicating whether the Popup part of the control are displayed.
FilterGets or sets a predicate which filters which items can be visible.
FilterExpressionGets or sets a filter expression which determines which items will be visible.
IsFilterActiveGets a value indicating whether there is a Filter or FilterExpression set.
ReadOnlyGets or sets a value indicating whether the drop down list is read only.

Methods

MethodDescription
FindItemExactReturns the RadListDataItem by a given text.
FindStringSearches 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.
FindStringExactSearches for an item in the same manner as FindString() but matches an item only if its text is exactly equal to the provided string.
FindStringNonWrappingSearches 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.
RebindForces re-evaluation of the current data source (if any).
ShowDropDownDisplays the pop-up on the screen.
CloseDropDownHides the popup from the screen.
BeginUpdateCalls BeginUpdate at the beginning of a block that makes many modifications in the GUI
EndUpdateCalls EndUpdate at the end of a block that makes many modifications in the GUI

Events

EventDescription
DataBindingCompleteFires after data binding operation has finished.
PopupOpeningFires when the pop-up form is about to be opened.
PopupOpenedFires when the pop-up form is opened.
PopupClosingFires when the pop-up is about to be closed.
PopupClosedFires when the pop-up is closed.
SelectedIndexChangedThis event fires when the selected index property changes.
SelectedIndexChangingThis event fires before SelectedIndex changes. This event allows the operation to be canceled.
SelectedValueChangedThis 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.
ItemDataBindingThis 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.
ItemDataBoundThis 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.
CreatingVisualListItemThis 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.
SortStyleChangedThis event fires when the SortStyle property changes.
VisualListItemFormattingThe 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
See Also
Not finding the help you need?
Contact Support