Class

RadDropDownListElement

Initializes a new instance of the RadDropDownListElement class.

Declaration

public RadDropDownListElement()

Identifies the IsDropDownShown dependency property.

Declaration

public static RadProperty IsDropDownShownProperty

Field Value

ArrowButton Property

Declaration

public virtual RadArrowButtonElement ArrowButton { get; set; }

Property Value

Get or sets the minimum width of the arrow button element.

Declaration

public virtual int ArrowButtonMinWidth { get; set; }

Property Value

AutoCompleteAppend Property

Declaration

public virtual AutoCompleteAppendHelper AutoCompleteAppend { get; set; }

Property Value

Represent list of all AutoComplete Helpers

Declaration

public virtual List<BaseAutoComplete> AutoCompleteHelpers { get; }

Property Value

Gets or sets the mode for the automatic text completion feature used in the RadDropDownListElement. Controls whether text is automatically completed while typing, displayed in a suggestion list, or both.

Declaration

[Browsable(true)]
public virtual AutoCompleteMode AutoCompleteMode { get; set; }

Property Value

AutoCompleteSuggest Property

Declaration

public virtual AutoCompleteSuggestHelper AutoCompleteSuggest { get; set; }

Property Value

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

[Browsable(true)]
public virtual bool AutoSizeItems { get; set; }

Property Value

Gets or sets the BindingContext for this object, which provides the foundation for data binding operations and can be inherited from parent objects.

Declaration

public override BindingContext BindingContext { get; set; }

Property Value

Overrides RadObject.BindingContext

Gets or sets a value indicating whether string comparisons are case-sensitive. When enabled, searching and filtering operations in the dropdown will match exact letter case.

Declaration

[Browsable(true)]
public bool CaseSensitive { get; set; }

Property Value

Gets or sets the name of the list or table in the data source for which the RadDropDownListElement is displaying data.

Declaration

public virtual string DataMember { get; set; }

Property Value

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

Declaration

public virtual object DataSource { get; set; }

Property Value

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

public virtual string DisplayMember { get; set; }

Property Value

Gets or sets the type of the DropDown animation.

Declaration

[Browsable(true)]
public virtual RadEasingType DropDownAnimationEasing { get; set; }

Property Value

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

Declaration

public virtual bool DropDownAnimationEnabled { get; set; }

Property Value

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

Declaration

[Browsable(true)]
public virtual int DropDownAnimationFrames { get; set; }

Property Value

Declaration

[Browsable(true)]
public virtual SizingMode DropDownSizingMode { get; set; }

Property Value

Gets or sets the style of the dropdown list control. This determines whether the control allows direct text input or only selection from a predefined list.

Declaration

[Browsable(true)]
public virtual RadDropDownStyle DropDownStyle { get; set; }

Property Value

Gets or sets the drop down minimum width.

Declaration

[Browsable(true)]
public virtual int DropDownWidth { get; set; }

Property Value

EditableElement Property

Declaration

[Browsable(false)]
public RadDropDownListEditableAreaElement EditableElement { get; set; }

Property Value

Get or set the text in Editable area

Declaration

public virtual string EditableElementText { get; set; }

Property Value

Enable or disable Mouse Wheel Scrolling.

Declaration

public bool EnableMouseWheel { get; set; }

Property Value

Gets or sets a Predicate that will be called for every data item in order to determine if the item will be visible.

Declaration

public Predicate<RadListDataItem> Filter { get; set; }

Property Value

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

Declaration

public string FilterExpression { get; set; }

Property Value

Gets the format provider used for formatting values in the dropdown list. This property provides advanced formatting capabilities for display values.

Declaration

[Browsable(false)]
public virtual IFormatProvider FormatInfo { get; set; }

Property Value

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

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

Declaration

public virtual bool FormattingEnabled { get; set; }

Property Value

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

Declaration

[Browsable(false)]
public bool IsFilterActive { get; }

Property Value

Gets a value that indicates if the popup associated with this RadDropDownListElement is open.

Declaration

public virtual bool IsPopupVisible { get; }

Property Value

Gets or sets the item height for the items.

Declaration

public virtual int ItemHeight { get; set; }

Property Value

Declaration

public RadListDataItemCollection Items { get; }

Property Value

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

Declaration

public int MaxLength { get; set; }

Property Value

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

Declaration

public string NullText { get; set; }

Property Value

Gets or sets the color of prompt text that is displayed when the TextBox contains no text

Declaration

public Color NullTextColor { get; set; }

Property Value

Gets or sets the direction of flow of the elements and whether elements are aligned to support locales using right-to-left fonts.

Declaration

public override bool RightToLeft { get; set; }

Property Value

Overrides RadElement.RightToLeft

Gets or sets a value indicating whether the control should automatically select the next item when the user double-clicks in the edit box area. This enables cycling through available options without opening the dropdown.

Declaration

[Browsable(true)]
public bool SelectNextOnDoubleClick { get; set; }

Property Value

Declaration

[Browsable(true)]
public virtual int SelectedIndex { get; set; }

Property Value

Declaration

[Browsable(false)]
[Bindable(true)]
public virtual RadListDataItem SelectedItem { get; set; }

Property Value

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

Declaration

[Browsable(false)]
public string SelectedText { get; set; }

Property Value

Declaration

[Browsable(false)]
[Bindable(true)]
public virtual object SelectedValue { get; set; }

Property Value

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

Declaration

[Browsable(false)]
public int SelectionLength { get; set; }

Property Value

For information on this property please refer to the MSDN.

Declaration

public SelectionMode SelectionMode { get; set; }

Property Value

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

Declaration

[Browsable(false)]
public int SelectionStart { get; set; }

Property Value

Gets or sets a value indicating whether the RadListDataItem image will be displayed in the editor element when DropDownStyle is set to DropDownList.

Declaration

public virtual bool ShowImageInEditorArea { get; set; }

Property Value

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

Gets or sets a value that determines whether to stop the selection events from firing. These are SelectedIndexChanged, SelectedIndexChanging and SelectedValueChanged.

Declaration

[Browsable(false)]
public bool SuspendSelectionEvents { get; set; }

Property Value

Gets or sets a value indicating whether the SelectedIndex is synchronized with the text in the editable area.

Declaration

public virtual bool SyncSelectionWithText { get; set; }

Property Value

TextBox Property

Declaration

public RadDropDownTextBoxElement TextBox { get; set; }

Property Value

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

public virtual string ValueMember { get; set; }

Property Value

Declaration

public virtual void BeginUpdate()

Declaration

protected virtual void CallTextChanged(object sender, EventArgs e)

Parameters

Declaration

protected virtual bool CanClosePopUp(RadPopupCloseReason reason, MouseButtons buttons)

Parameters

Returns

Declaration

protected virtual bool CanCreateArrowButtonElement()

Returns

Closes the dropdown popup with the specified reason.

Declaration

public override void ClosePopup(RadPopupCloseReason reason)

Parameters

Overrides PopupEditorBaseElement.ClosePopup(RadPopupCloseReason)

Declaration

protected virtual void ClosePopupCore()

Declaration

protected virtual RadDropDownListArrowButtonElement CreateArrowButtonElement()

Returns

Creates the auto complete append handler.

Declaration

protected virtual AutoCompleteAppendHelper CreateAutoCompleteAppendHandler()

Returns

Creates the auto complete suggest helper.

Declaration

protected virtual AutoCompleteSuggestHelper CreateAutoCompleteSuggestHelper()

Returns

Creates the visual elements that make up the RadDropDownListElement. This method initializes the border, fill, layout container and child elements.

Declaration

protected override void CreateChildElements()

Overrides PopupEditorElement.CreateChildElements()

Declaration

protected virtual StackLayoutElement CreateElementsContainer()

Returns

Creates and initializes the popup form used for the dropdown list.

Declaration

protected override RadPopupControlBase CreatePopupForm()

Returns

Overrides PopupEditorBaseElement.CreatePopupForm()

Declaration

protected virtual RadDropDownListEditableAreaElement CreateTextEditorElement()

Returns

Defers the refresh.

Declaration

public virtual IDisposable DeferRefresh()

Returns

Releases the managed resources used by the RadDropDownListElement.

Declaration

protected override void DisposeManagedResources()

Overrides PopupEditorElement.DisposeManagedResources()

Declaration

public virtual void EndUpdate()

Handles the action when the Enter key is pressed or when the control loses focus.

Declaration

protected virtual void EnterPressedOrLeaveControl()

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)

Parameters

Returns

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

Returns

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 virtual int FindStringExact(string s)

Parameters

Returns

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 virtual int FindStringExact(string s, int startIndex)

Parameters

Returns

Attempts to set the keyboard focus to the element.

Declaration

public override bool Focus()

Returns

Overrides RadElement.Focus()

Declaration

protected virtual void HandleEnterCore()

Declaration

protected virtual void HandleOnKeyUpKeyDownPress(KeyEventArgs keyEventArgs)

Parameters

Declaration

protected virtual void HandleSelectNextOrPrev(bool next, bool startFromBeginningIfEndReached)

Parameters

Declaration

public virtual bool IsUpdating()

Returns

Provides the custom measurement logic for the RadDropDownListElement.

Declaration

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

Returns

Overrides RadElement.MeasureOverride(SizeF)

main update entry point

Declaration

public override void NotifyOwner(PopupEditorNotificationData notificationData)

Parameters

Overrides PopupEditorElement.NotifyOwner(PopupEditorNotificationData)

Called when the AutoComplete data source has changed.

Declaration

protected override void OnAutoCompeleteDataSourceChanged()

Overrides PopupEditorElement.OnAutoCompeleteDataSourceChanged()

Handles bubbled events from child elements in the visual tree.

Declaration

protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)

Parameters

Overrides RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)

Handles the double-click event to select the next item when configured.

Declaration

protected override void OnDoubleClick(EventArgs e)

Parameters

Overrides RadElement.OnDoubleClick(EventArgs)

Called when the items collection of the dropdown list has changed.

Declaration

protected virtual void OnItemsChanged()

Declaration

protected virtual void OnItemsClear()

Declaration

public virtual void OnKeyDown(KeyEventArgs e)

Parameters

Declaration

public virtual void OnKeyPress(KeyPressEventArgs e)

Parameters

Declaration

protected void OnKeyPress(RadDropDownListEditableAreaElement sender, KeyPressEventArgs e)

Parameters

Declaration

public virtual void OnKeyUp(KeyEventArgs e)

Parameters

Declaration

protected virtual void OnListItemDataBinding(object sender, ListItemDataBindingEventArgs args)

Parameters

Declaration

protected virtual void OnListItemDataBound(object sender, ListItemDataBoundEventArgs args)

Parameters

Called when the element is loaded into the element tree.

Declaration

protected override void OnLoaded()

Overrides RadElement.OnLoaded()

Handles the mouse wheel events to enable scrolling through items.

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Overrides RadElement.OnMouseWheel(MouseEventArgs)

Declaration

protected virtual void OnMouseWheelCore(MouseEventArgs e)

Parameters

Occurs when the parent element of this element has changed.

Declaration

protected override void OnParentChanged(RadElement previousParent)

Parameters

Overrides RadElement.OnParentChanged(RadElement)

Called when the popup is closed.

Declaration

protected override void OnPopupClosed(object sender, RadPopupClosedEventArgs args)

Parameters

Overrides PopupEditorElement.OnPopupClosed(object, RadPopupClosedEventArgs)

Called when the dropdown popup is opened.

Declaration

protected override void OnPopupOpened(object sender, EventArgs e)

Parameters

Overrides PopupEditorElement.OnPopupOpened(object, EventArgs)

Called when a property value changes.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides PopupEditorBaseElement.OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration

protected virtual void OnSelectedIndexChanged(object sender, PositionChangedEventArgs e)

Parameters

Declaration

protected bool OnSelectedIndexChanging(object sender, PositionChangingCancelEventArgs e)

Parameters

Returns

Declaration

protected virtual void OnSelectedValueChanged(object sender, ValueChangedEventArgs e)

Parameters

Declaration

protected virtual void OnSortStyleChanged(SortStyle sortStyle)

Parameters

Declaration

protected void OnTextChanged(RadDropDownListEditableAreaElement sender, EventArgs args)

Parameters

Declaration

protected virtual void OnVisualElementCreated(object sender, CreatingVisualListItemEventArgs args)

Parameters

Declaration

protected virtual void OnVisualItemFormatting(RadListVisualItem item)

Parameters