Click or drag to resize
RadComboBox Class
Represents a selection control with a drop-down list that can be shown or hidden by clicking the arrow on the control.
Inheritance Hierarchy
SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsControl
              System.Windows.ControlsItemsControl
                System.Windows.Controls.PrimitivesSelector
                  System.Windows.Controls.PrimitivesMultiSelector
                    Telerik.Windows.ControlsRadComboBox
                      Telerik.Windows.ControlsDurationPicker
                      Telerik.Windows.ControlsRadRibbonComboBox

Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Input (in Telerik.Windows.Controls.Input.dll) Version: 2017.3.913.40 (2017.3.913.40)
Syntax
public class RadComboBox : MultiSelector, 
	IThemable, IPopupWrapperOwner

The RadComboBox type exposes the following members.

Constructors
  NameDescription
Public methodRadComboBox
Initializes a new instance of the RadComboBox class.
Top
Methods
  NameDescription
Protected methodChangeVisualState
Updates the visual state of the control.
Protected methodClearContainerForItemOverride
When overridden in a derived class, undoes the effects of the PrepareContainerForItemOverride(DependencyObject, Object) method.
(Overrides SelectorClearContainerForItemOverride(DependencyObject, Object).)
Protected methodGetContainerForItemOverride
Creates or identifies the element that is used to display the given item.
(Overrides ItemsControlGetContainerForItemOverride.)
Protected methodHandleKeyDown
Contains the keyboard navigation logic of RadComboBox.
Protected methodHandleTextInput
Contains the text input logic of RadComboBox when the control is not editable. This method is called from a TextInput event handler.
Protected methodIsItemItsOwnContainerOverride
Determines if the specified item is (or is eligible to be) its own container.
(Overrides ItemsControlIsItemItsOwnContainerOverride(Object).)
Public methodOnApplyTemplate
When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate.
(Overrides FrameworkElementOnApplyTemplate.)
Protected methodOnCreateAutomationPeer
Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.
(Overrides UIElementOnCreateAutomationPeer.)
Protected methodOnDropDownClosed
Raises the [E:DropDownClosed] event.
Protected methodOnDropDownOpened
Raises the [E:DropDownOpened] event.
Protected methodOnInitialized
Raises the Initialized event. This method is invoked whenever IsInitialized is set to true internally.
(Overrides SelectorOnInitialized(EventArgs).)
Protected methodOnIsDropDownOpenChanged
Called when the IsDropDownOpen property is changed.
Protected methodOnIsEditableChanged
Called when the IsEditable property is changed.
Protected methodOnIsKeyboardFocusWithinChanged
Called when the IsKeyboardFocusWithin property has changed.
(Overrides SelectorOnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs).)
Protected methodOnIsMouseWheelEnabledChanged
Called when the IsMouseWheelEnabled property is changed.
Protected methodOnMouseWheel
Called before the MouseWheel event occurs to provide handling for the event in a derived class without attaching a delegate.
(Overrides UIElementOnMouseWheel(MouseWheelEventArgs).)
Protected methodOnSelectionChanged
Called when the selection changes.
(Overrides SelectorOnSelectionChanged(SelectionChangedEventArgs).)
Protected methodOnTextBoxStyleChanged
Called when the TextBoxStyle property is changed.
Protected methodOnTextChanged
Called when the Text property is changed.
Protected methodOnTextInput
Invoked when the TextInput event is received.
(Overrides ItemsControlOnTextInput(TextCompositionEventArgs).)
Protected methodPrepareContainerForItemOverride
Prepares the specified element to display the specified item.
(Overrides SelectorPrepareContainerForItemOverride(DependencyObject, Object).)
Top
Extension Methods
  NameDescription
Public Extension MethodChildrenOfTypeT
Gets all child elements recursively from the visual tree by given type.
(Defined by ChildrenOfTypeExtensions.)
Public Extension MethodClearIfNoBindingAndSet
Clears if set.
(Defined by CommonExtensions.)
Public Extension MethodClearIfSet
Clears the property if a value has been set.
(Defined by CommonExtensions.)
Public Extension MethodDeserializePrimitives
Deserializes some primitive properties of a control.
(Defined by SerializationExtensions.)
Public Extension MethodEnableLayoutRounding (Defined by LayoutRoundingHelperExtensions.)
Public Extension MethodFindChildByTypeT
Finds child element of the specified type. Uses breadth-first search.
(Defined by ChildrenOfTypeExtensions.)
Public Extension MethodGetAssociatedInlineUIContainer (Defined by ExtensionMethods.)
Public Extension MethodGetAssociatedLayoutBox (Defined by ExtensionMethods.)
Public Extension MethodGetBaseControlItemStatus
Gets a string that communicates the visual status of a Control.
(Defined by AutomationExtensions.)
Public Extension MethodGetBoundsRelativeTo
Gets the bounds relative to the current framework element.
(Defined by ExtensionMethods.)
Public Extension MethodGetGlobalMousePosition
(Defined by WindowHost.)
Public Extension MethodGetParents
Enumerates through element's parents in the visual tree.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodGetVisualParentT
Searches up in the visual tree for parent element of the specified type.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodIsAncestorOf(DependencyObject)Overloaded.
Determines whether the element is ancestor of the current UI element.
(Defined by ExtensionMethods.)
Public Extension MethodIsAncestorOf(DependencyObject)Overloaded.
Determines whether the element is an ancestor of the descendant.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodIsKeyboardFocusWithin
Determines whether keyboard focus is within the current UI element.
(Defined by KeyboardHelper.)
Public Extension MethodIsLocalValueSet(DependencyProperty)Overloaded.
Determines whether the specified dependency property local value is set.
(Defined by DependencyObjectExtensions.)
Public Extension MethodIsLocalValueSet(DependencyProperty)Overloaded.
Determines whether the specified dependency property local value is set.
(Defined by CommonExtensions.)
Public Extension MethodParentOfTypeT
Gets the parent element from the visual tree by given type.
(Defined by ParentOfTypeExtensions.)
Public Extension MethodSerializePrimitives
Serializes some primitive properties of a control.
(Defined by SerializationExtensions.)
Public Extension MethodSetAssociatedLayoutBox (Defined by ExtensionMethods.)
Public Extension MethodSetIfDifferent
Sets the value of the dependencyProperty property if it's hasn't that value currently.
(Defined by CommonExtensions.)
Public Extension MethodSetLayout
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSetLocation(Point)Overloaded.
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSetLocation(Double, Double)Overloaded.
Sets the location in the element in Canvas.
(Defined by CommonExtensions.)
Public Extension MethodSlideInOverloaded.
Slides the given element into view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideIn(TimeSpan)Overloaded.
Slides the given element into view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideOutOverloaded.
Slides the given element out of view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodSlideOut(TimeSpan)Overloaded.
Slides the given element out of view. This is an extension method.
(Defined by CalendarAnimation.)
Public Extension MethodTranslate(NullableDouble, NullableDouble, NullableDouble, NullableDouble, TimeSpan)Overloaded.
Translates the target element as requested by the parameters.
(Defined by CalendarAnimation.)
Public Extension MethodTranslate(NullableDouble, NullableDouble, NullableDouble, NullableDouble, TimeSpan, Action)Overloaded.
Translates the target element as requested by the parameters and executes the action request.
(Defined by CalendarAnimation.)
Top
Fields
  NameDescription
Public fieldStatic memberAllowMultipleSelectionProperty
Identifies the AllowMultipleSelection dependency property.
Public fieldStatic memberCanAutocompleteSelectItemsProperty
Identifies the CanAutocompleteSelectItems dependency property.
Public fieldStatic memberCanKeyboardNavigationSelectItemsProperty
Identifies the CanKeyboardNavigationSelectItems dependency property.
Public fieldStatic memberClearSelectionButtonContentProperty
Identifies the ClearSelectionButtonContent dependency property.
Public fieldStatic memberClearSelectionButtonVisibilityProperty
Identifies the learSelectionButtonVisibility dependency property.
Public fieldStatic memberCommandParameterProperty
Identifies the CommandParameter dependency property.
Public fieldStatic memberCommandProperty
Identifies the Command dependency property.
Public fieldStatic memberCommandTargetProperty
Identifies the CommandParameter dependency property.
Public fieldStatic memberDropDownWidthProperty
Identifies the DropDownWidth dependency property.
Public fieldStatic memberEditableTemplateProperty
Identifies the EditableTemplate dependency property.
Public fieldStatic memberEmptySelectionBoxTemplateProperty
Identifies the EmptySelectionBoxTemplate dependency property.
Public fieldStatic memberEmptyTextProperty
Identifies the EmptyText dependency property.
Public fieldStatic memberFilteringModeProperty
Identifies the FilteringMode dependency property.
Public fieldStatic memberIsDropDownOpenProperty
Identifies the IsDropDownOpen dependency property.
Public fieldStatic memberIsDropDownTabNavigationEnabledProperty
Identifies the IsDropDownTabNavigationEnabled dependency property.
Public fieldStatic memberIsEditableProperty
Identifies the IsEditable dependency property.
Public fieldStatic memberIsFilteringEnabledProperty
Identifies the FilteringMode dependency property.
Public fieldStatic memberIsHighlightedProperty
Identifies the IsHighlighted dependency property.
Public fieldStatic memberIsMouseWheelEnabledProperty
Identifies the IsMouseWheelEnabledProperty dependency property.
Public fieldStatic memberIsReadOnlyProperty
Identifies the IsReadOnly dependency property.
Public fieldStatic memberIsWatermarkVisibleProperty
Identifies the IsWatermarkVisible dependency property.
Public fieldStatic memberMaxDropDownHeightProperty
Identifies the MaxDropDownHeight dependency property.
Public fieldStatic memberMinDropDownWidthProperty
Identifies the MinDropDownWidth readonly dependency property.
Public fieldStatic memberMultipleSelectionBoxTemplateProperty
Identifies the MultipleSelectionBoxTemplate dependency property.
Public fieldStatic memberMultipleSelectionSeparatorProperty
Identifies the MultipleSelectionSeparator dependency property.
Public fieldStatic memberMultipleSelectionSeparatorStringFormatProperty
Identifies the MultipleSelectionSeparatorStringFormat dependency property.
Public fieldStatic memberNonEditableTemplateProperty
Identifies the NonEditableTemplate dependency property.
Public fieldStatic memberOpenDropDownOnFocusProperty
Identifies the OpenDropDownOnFocus dependency property.
Public fieldStatic memberSelectAllTextEventProperty
Identifies the SelectAllTextEvents dependency property.
Public fieldStatic memberSelectionBoxItemProperty
Identifies the SelectionBoxItem dependency property.
Public fieldStatic memberSelectionBoxItemTemplateProperty
Identifies the SelectionBoxItemTemplate dependency property.
Public fieldStatic memberSelectionBoxTemplateProperty
Identifies the SelectionBoxTemplate dependency property.
Public fieldStatic memberStaysOpenOnEditProperty
Identifies the StaysOpenOnEdit dependency property.
Public fieldStatic memberTextBoxStyleProperty
Identifies the TextBoxStyle dependency property.
Public fieldStatic memberTextProperty
Identifies the Text dependency property.
Public fieldStatic memberTextSearchModeProperty
Identifies the FilteringMode dependency property.
Public fieldStatic memberUpdateSelectionOnLostFocusProperty
Identifies the UpdateSelectionOnLostFocus dependency property.
Top
Properties
  NameDescription
Public propertyAllowMultipleSelection
Gets or sets the value that indicates whether multiple item can be selected at the same time. This is a dependency property.
Public propertyCanAutocompleteSelectItems
Gets or sets the value specifying whether typing a text in a RadComboBox should change the selection or not. This property is applicable only when the DropDown of the control is opened.
Public propertyCanKeyboardNavigationSelectItems
Gets or sets the value specifying whether the keyboard navigation in a RadComboBox should change the selection.
Public propertyClearSelectionButtonContent
Gets or sets the content of the button clearing the selection. This is a dependency property.
Public propertyClearSelectionButtonVisibility
Gets or sets the visibility of the button clearing the selection. This is a dependency property.
Public propertyCommand
Gets or sets the command that will be executed when the command source is invoked.
Public propertyCommandParameter
Represents a user defined data value that can be passed to the command when it is executed.
Public propertyCommandTarget
The object that the command is being executed on.
Public propertyDropDownWidth
Gets or sets the width of the DropDown of the RadComboBox.
Public propertyEditableTemplate
Gets or sets the ControlTemplate for RadCombBox when IsEditable is true.
Public propertyEmptySelectionBoxTemplate
Gets or sets the DataTemplate that should be applied on the selection box ContentPresenter when there is no selection. This is a dependency property.
Public propertyEmptyText
Gets or sets a string that should be displayed in the selection box ContentPresenter when there is no selection. This is a dependency property.
Public propertyFilteringBehavior
Gets or sets the behavior which is used when filtering logic applies.
Protected propertyHandlesScrolling
Gets a value that indicates whether a control supports scrolling.
(Overrides ControlHandlesScrolling.)
Public propertyIsDropDownOpen
Gets or sets the value that indicates whether the RadComboBox dropdown is currently open. This is a dependency property.
Public propertyIsDropDownTabNavigationEnabled
Gets or sets a value indicating whether tab navigation inside the drop down portion of control is enabled. The property affects only non editable RadComboBox This is a dependency property.
Public propertyIsEditable
Gets or sets a value that enables or disables editing of the text in text box of the RadComboBox. This is a dependency property.
Public propertyIsFilteringEnabled
Gets or sets the value indicating whether the filtering is enabled. This is a dependency property.
Public propertyIsHighlighted
Gets or sets a value indicating whether this instance is highlighted.
Public propertyIsMouseWheelEnabled
Gets or sets the value indicating whether the instance will respond to MouseWheel events when the dropdown is not open.
Public propertyIsReadOnly
Gets or sets a value that enables selection-only mode, in which the contents of the RadComboBox are selectable but not editable. This is a dependency property.
Public propertyIsWatermarkVisible
Gets a value indicating whether the watermark of this instance should be visible, or not.
Public propertyMaxDropDownHeight
Gets or sets the maximum height for a RadComboBox drop-down. This is a dependency property.
Public propertyMinDropDownWidth
Gets the minimum width of a RadComboBox drop-down. This is a readonly dependency property.
Public propertyMultipleSelectionBoxTemplate
Get or sets the DataTemplate to be used in multiple selection mode when the ComboBox is non editable. This is a dependency property.
Public propertyMultipleSelectionSeparator
Get or sets the char separator used for separating the selected items.
Public propertyMultipleSelectionSeparatorStringFormat
Get or sets the char separator string form used for separating the selected items. This string format is removed while editing the text (when editable and focused).
Public propertyNonEditableTemplate
Gets or sets the ControlTemplate for RadCombBox when IsEditable is false.
Public propertyOpenDropDownOnFocus
Gets or sets a value that specifies whether the dropdown should be opened when the control gets the focus, or not. This is a dependency property.
Public propertySelectAllTextEvent
Gets or sets the value that specifies the name of the event that will select the text of the TextBox when IsEditable=true.
Public propertySelectionBoxItem
Gets the item that is currently visible in the selection box ContentPresenter. This is a dependency property.
Public propertySelectionBoxItemTemplate
Gets the DataTemplate that will be applied on the selection box ContentPresenter. This is a dependency property.
Public propertySelectionBoxTemplate
Gets or sets the DataTemplate that should be applied on the selection box ContentPresenter when there is a selected item. This is a dependency property.
Public propertyStaysOpenOnEdit
Gets or sets whether a ComboBox that is open and displays a drop-down control will remain open when a user clicks the TextBox. This is a dependency property.
Public propertyText
Gets or sets the text of the currently selected item. This is a dependency property.
Public propertyTextBoxStyle
Gets or sets the style of the TextBox into the RadComboBox. This is a dependency property.
Protected propertyTextInputString
Gets or sets the current text input that the user entered when IsEditable=false or IsReadOnly=true.
Public propertyTextSearchMode
Specifies the filtering mode for the RadComboBox. This is a dependency property.
Public propertyUpdateSelectionOnLostFocus
Gets or sets value indicating whether to update the selection only when the focus moved out of the control or Enter key is pressed. The property affects only editable and single selection RadComboBox. This is a dependency property.
Public propertyUpdateTextOnLostFocus
Gets or sets a value that indicates if the Text of the control should be updated when the LostFocus event is raised. This is a dependency property.
Top
Events
  NameDescription
Public eventDropDownClosed
Occurs when the drop-down list of the combo box closes.
Public eventDropDownOpened
Occurs when the drop-down list of the combo box opens.
Top
See Also