BaseComboBoxElement
Represents a combo box element.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[ComVisible(false)]
[LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "SelectedValue")]
public abstract class BaseComboBoxElement : PopupEditorBaseElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IInputEditor, IValueEditor, ISupportInitializeInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadEditorElementEditorBaseElementPopupEditorBaseElementBaseComboBoxElement...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadComboBoxElement class.
public BaseComboBoxElement()Fields
public static RadProperty IsDropDownShownPropertyprotected char lastPressedCharprotected string LastTypedTextprotected ComboBoxEditorLayoutPanel layoutPaneltextBox
RadTextBoxItem
protected RadTextBoxItem textBoxProperties
Gets the arrow button element.
public RadArrowButtonElement ArrowButton { get; }public int ArrowButtonMinWidth { get; set; }Specifies the mode for the automatic completion feature used in the ComboBox and the TextBox controls.
[Browsable(true)]
public virtual AutoCompleteMode AutoCompleteMode { get; set; }Gets or set the value in Milliseconds indicating delay between last key press and filtering operation
public int AutoFilterDelay { get; set; }Gets or sets a value indicating whether string comparisons are case-sensitive.
[Browsable(true)]
public bool CaseSensitive { get; set; }Gets the border element.
public BorderPrimitive ComboBoxBorder { get; }Gets the fill element.
public FillPrimitive ComboBoxFill { get; }Gets or sets the data source.
public abstract object DataSource { get; set; }Rotate items on double click in the edit box part
[Browsable(true)]
public bool DblClickRotate { get; set; }Gets or sets the property to display.
[TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public abstract string DisplayMember { get; set; }Gets or sets the type of the DropDown animation.
[Browsable(true)]
public RadEasingType DropDownAnimationEasing { get; set; }Gets or sets a value indicating whether the ComboBox DropDown will be enabled when it shows.
[Browsable(true)]
public bool DropDownAnimationEnabled { get; set; }Gets or sets the number of frames that will be used when the DropDown is being animated.
[Browsable(true)]
public int DropDownAnimationFrames { get; set; }Gets or sets the height in pixels of the drop-down portion of the ComboBox.
[Browsable(true)]
public int DropDownHeight { get; set; }[Browsable(true)]
public Size DropDownMaxSize { get; set; }[Browsable(true)]
public Size DropDownMinSize { get; set; }[Browsable(true)]
public abstract SizingMode DropDownSizingMode { get; set; }Gets or sets a value specifying the style of the combo box.
[Browsable(true)]
public RadDropDownStyle DropDownStyle { get; set; }Gets or sets the width of the of the drop-down portion of a combo box.
[Browsable(true)]
public int DropDownWidth { get; set; }Gets or sets the IFormatProvider that provides custom formatting behavior.
[Browsable(false)]
public abstract IFormatProvider FormatInfo { get; set; }Gets or sets the format-specifier characters that indicate how a value is to be displayed.
public abstract string FormatString { get; set; }Gets or sets a value indicating whether formatting is applied to the DisplayMember property.
public abstract bool FormattingEnabled { get; set; }protected abstract bool IndexChanging { get; set; }Gets or sets a value indicating whether the control should show or not partial items.
public abstract bool IntegralHeight { get; set; }Gets a value indicating whether the drop down is shown.
public bool IsDropDownShown { get; }Gets a value indicating whether the combo box is displaying its drop-down portion.
[Browsable(false)]
public bool IsDroppedDown { get; }Gets whether the text input control of the combo box is in editable mode.
public bool IsWritable { get; }Gets a collection representing the items contained in this ComboBox.
public abstract RadItemCollection Items { get; }LimitToList Property
public bool LimitToList { get; set; }Gets or sets the maximum number of items to be shown in the drop-down portion of the ComboBox.
public int MaxDropDownItems { get; set; }Gets or sets the maximum number of characters the user can type or paste into the text box control.
public int MaxLength { get; set; }Gets or sets the text that is displayed when the ComboBox contains a null reference.
public string NullText { get; set; }Gets or sets a boolean value determining whether the user can scroll through the items when the popup is closed by using the mouse wheel.
public bool ScrollOnMouseWheel { get; set; }Gets or sets the index specifying the currently selected item.
[Browsable(true)]
public abstract int SelectedIndex { get; set; }Gets or sets the currently selected item.
[Browsable(false)]
[Bindable(true)]
public abstract object SelectedItem { get; set; }Gets or sets the text that is selected in the editable portion of the ComboBox.
[Browsable(false)]
public string SelectedText { get; set; }Gets or sets value specifying the currently selected item.
[Browsable(false)]
[Bindable(true)]
public abstract object SelectedValue { get; set; }Gets or sets the number of characters selected in the editable portion of the combo box.
[Browsable(false)]
public int SelectionLength { get; set; }Gets or sets the starting index of text selected in the combo box.
[Browsable(false)]
public int SelectionStart { get; set; }Gets or sets a value indicating the sort style the of items in the combo box.
public SortStyle Sorted { get; set; }public LightVisualElement TextboxContentElement { get; set; }Gets the TextBoxElement which is used in the ComboBox.
[Browsable(false)]
public RadTextBoxElement TextBoxElement { get; }Gets or sets t he property to use as the actual value for the items.
public abstract string ValueMember { get; set; }Gets or sets a value indicating whether RadScrollViewer uses UI virtualization.
[Browsable(true)]
public abstract bool Virtualized { get; set; }public override EditorVisualMode VisualMode { get; }Overrides:
Methods
protected virtual void ApplyThemeToPopupForm()public override void BeginEdit()Overrides:
Call BeginUpdate at the begining of a block that makes many modifications in the GUI EndUpdate()
public abstract void BeginUpdate()Called by the element when constructed. Allows inheritors to build the element tree.
protected override void CreateChildElements()Overrides:
Releases managed resources used by this element.
protected override void DisposeManagedResources()Overrides:
protected abstract void DoScrollLineDown()protected abstract void DoScrollLineUp()Call BeginUpdate at the end of a block that makes many modifications in the GUI BeginUpdate()
public abstract void EndUpdate()Finds the index of the item with the specified text. The passed argument is compared with the DisplayMember value for each item in the items collection.
Called when the bubble phase of a routed event occurs.
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)The element that originally raised the event.
argsRoutedEventArgsThe routed event arguments.
Overrides:
Raises the CaseSensitiveChanged event.
Raises the DoubleClick event.
Raises the DropDownStyleChanged event.
Raises the MouseWheel event.
protected override void OnMouseWheel(MouseEventArgs e)The mouse event arguments.
Overrides:
Raises the standard .NET PropertyChanged event with the specified property name to notify subscribers of property value changes.
protected override void OnNotifyPropertyChanged(string propertyName)The name of the property that changed.
Overrides:
protected override void OnPopupClosed(RadPopupClosedEventArgs e)Overrides:
Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The property changed event arguments.
Overrides:
Called before a property value is changed, allowing for validation or cancellation of text changes.
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)The property changing event arguments.
Overrides:
Raises the SelectedIndexChanged event.
Raises the SelectedValueChanged event.
Raises the SortedChanged event.
Called when the tunnel phase of a routed event occurs.
protected override void OnTunnelEvent(RadElement sender, RoutedEventArgs args)The element that originally raised the event.
argsRoutedEventArgsThe routed event arguments.
Overrides:
Processes the Escape key
public virtual bool ProcessEscKey(KeyEventArgs e)An instance of KeyEventArgs
Returns:true if the event is processed, false otherwise
protected virtual void ProcessKeyDown(object sender, KeyEventArgs e)Processes the Enter key
public virtual void ProcessReturnKey(KeyEventArgs e)An instance of KeyEventArgs
protected virtual void ProcessTextKeyUp(object sender, KeyEventArgs e)protected abstract void ScrollToHome()Selects all the text in the editable portion of the combo box.
public void SelectAll()protected virtual void SelectNextItem()protected virtual void SelectPreviousItem()protected virtual void SetSuggestAutoComplete()Displays the popup on the screen.
public override void ShowPopup()Overrides:
protected virtual void TextBox_TextChanging(object sender, TextChangingEventArgs e)protected virtual void UnwireEvents()protected virtual void WireEvents()Events
Occurs when the CaseSensitive property has changed.
[Browsable(true)]
public event EventHandler CaseSensitiveChanged[Browsable(true)]
public event EventHandler DropDownStyleChangedOccurs when the SelectedIndex property has changed.
[Browsable(true)]
public event EventHandler SelectedIndexChangedFires when the selected value is changed.
[Browsable(true)]
public event EventHandler SelectedValueChangedOccurs when the Sorted property has changed.
[Browsable(true)]
public event EventHandler SortedChanged