ClassRadMultiColumnComboBox
Represents a multi-column combo box control that allows users to select multiple items with enhanced search capabilities and customizable templates. This class derives from Control and implements the IThemable interface, allowing for theming support. The RadMultiColumnComboBox features options to customize the dropdown content, styling, and search behavior, as well as properties for managing selection visibility, editor requirements, and footer content. Events such as InitializeDropDownContentManager enable further customization during the initialization of the drop-down content manager.
Definition
Namespace:Telerik.Windows.Controls
Assembly:Telerik.Windows.Controls.GridView.dll
Syntax:
[TelerikToolboxCategory("Data")]
public class RadMultiColumnComboBox : Control
Inheritance: objectRadMultiColumnComboBox
Constructors
RadMultiColumnComboBox()
Initializes a new instance of the RadMultiColumnComboBox class.
Declaration
public RadMultiColumnComboBox()
Fields
AutoCompleteModeProperty
Represents the AutoCompleteMode dependency property.
Declaration
public static readonly DependencyProperty AutoCompleteModeProperty
Field Value
DependencyProperty
AutoCompleteProviderProperty
Represents the AutoCompleteProvider dependency property.
Declaration
public static readonly DependencyProperty AutoCompleteProviderProperty
Field Value
DependencyProperty
CanUserResizeDropDownProperty
Represents the CanUserResizeDropDown dependency property.
Declaration
public static readonly DependencyProperty CanUserResizeDropDownProperty
Field Value
DependencyProperty
ClearSelectionOnDeleteOrBackKeyProperty
Identifies the ClearSelectionOnDeleteOrBackKey property.
Declaration
public static readonly DependencyProperty ClearSelectionOnDeleteOrBackKeyProperty
Field Value
DependencyProperty
CloseDropDownAfterSelectionInputProperty
Represents the CloseDropDownAfterInputSelection dependency property.
Declaration
public static readonly DependencyProperty CloseDropDownAfterSelectionInputProperty
Field Value
DependencyProperty
DeferTextChangeProperty
Represents the DeferTextChange dependency property.
Declaration
public static readonly DependencyProperty DeferTextChangeProperty
Field Value
DependencyProperty
DisplayMemberPathProperty
Represents the DisplayMemberPath dependency property.
Declaration
public static readonly DependencyProperty DisplayMemberPathProperty
Field Value
DependencyProperty
DropDownContentManagerProperty
Represents the DropDownContentManager dependency property.
Declaration
public static readonly DependencyProperty DropDownContentManagerProperty
Field Value
DependencyProperty
DropDownElementStyleProperty
Represents the DropDownElementStyle dependency property.
Declaration
public static readonly DependencyProperty DropDownElementStyleProperty
Field Value
DependencyProperty
DropDownHeightProperty
Represents the DropDownHeight dependency property.
Declaration
public static readonly DependencyProperty DropDownHeightProperty
Field Value
DependencyProperty
DropDownMaxHeightProperty
Represents the DropDownMaxHeight dependency property.
Declaration
public static readonly DependencyProperty DropDownMaxHeightProperty
Field Value
DependencyProperty
DropDownMaxWidthProperty
Represents the DropDownMaxWidth dependency property.
Declaration
public static readonly DependencyProperty DropDownMaxWidthProperty
Field Value
DependencyProperty
DropDownMinHeightProperty
Represents the DropDownMinHeight dependency property.
Declaration
public static readonly DependencyProperty DropDownMinHeightProperty
Field Value
DependencyProperty
DropDownMinWidthProperty
Represents the DropDownMinWidth dependency property.
Declaration
public static readonly DependencyProperty DropDownMinWidthProperty
Field Value
DependencyProperty
DropDownPlacementProperty
Represents the DropDownPlacement dependency property.
Declaration
public static readonly DependencyProperty DropDownPlacementProperty
Field Value
DependencyProperty
DropDownWidthProperty
Represents the DropDownWidth dependency property.
Declaration
public static readonly DependencyProperty DropDownWidthProperty
Field Value
DependencyProperty
EditorMinWidthProperty
Represents the EditorMinWidth dependency property.
Declaration
public static readonly DependencyProperty EditorMinWidthProperty
Field Value
DependencyProperty
FooterContentProperty
Represents the FooterContent dependency property.
Declaration
public static readonly DependencyProperty FooterContentProperty
Field Value
DependencyProperty
FooterContentTemplateProperty
Represents the FooterContentTemplate dependency property.
Declaration
public static readonly DependencyProperty FooterContentTemplateProperty
Field Value
DependencyProperty
FooterVisibilityProperty
Represents the FooterVisibility dependency property.
Declaration
public static readonly DependencyProperty FooterVisibilityProperty
Field Value
DependencyProperty
HighlightMatchesProperty
Represents the HighlightMatches dependency property.
Declaration
public static readonly DependencyProperty HighlightMatchesProperty
Field Value
DependencyProperty
IsReadOnlyProperty
Represents the IsReadOnly dependency property.
Declaration
public static readonly DependencyProperty IsReadOnlyProperty
Field Value
DependencyProperty
ItemsSourceProviderProperty
Represents the ItemsSourceProvider dependency property.
Declaration
public static readonly DependencyProperty ItemsSourceProviderProperty
Field Value
DependencyProperty
KeepDropDownOpenProperty
Represents the KeepDropDownOpen dependency property.
Declaration
public static readonly DependencyProperty KeepDropDownOpenProperty
Field Value
DependencyProperty
MatchCaseProperty
Represents the MatchCase dependency property.
Declaration
public static readonly DependencyProperty MatchCaseProperty
Field Value
DependencyProperty
NullTextProperty
Represents the NullText dependency property.
Declaration
public static readonly DependencyProperty NullTextProperty
Field Value
DependencyProperty
OpenDropDownOnFocusProperty
Represents the OpenDropDownOnFocus dependency property.
Declaration
public static readonly DependencyProperty OpenDropDownOnFocusProperty
Field Value
DependencyProperty
OpenDropDownOnInputProperty
Represents the OpenDropDownOnInput dependency property.
Declaration
public static readonly DependencyProperty OpenDropDownOnInputProperty
Field Value
DependencyProperty
SearchModeProperty
Identifies the SearchMode dependency property.
Declaration
public static readonly DependencyProperty SearchModeProperty
Field Value
DependencyProperty
SearchStateManagerProperty
Represents the SearchStateManager dependency property.
Declaration
public static readonly DependencyProperty SearchStateManagerProperty
Field Value
DependencyProperty
SelectedIndexProperty
Represents the SelectedIndex dependency property.
Declaration
public static readonly DependencyProperty SelectedIndexProperty
Field Value
DependencyProperty
SelectedItemProperty
Represents the SelectedItem dependency property.
Declaration
public static readonly DependencyProperty SelectedItemProperty
Field Value
DependencyProperty
SelectedItemsProperty
Represents the SelectedItems dependency property.
Declaration
public static readonly DependencyProperty SelectedItemsProperty
Field Value
DependencyProperty
SelectedValuePathProperty
Represents the SelectedValuePath dependency property.
Declaration
public static readonly DependencyProperty SelectedValuePathProperty
Field Value
DependencyProperty
SelectedValueProperty
Represents the SelectedValue dependency property.
Declaration
public static readonly DependencyProperty SelectedValueProperty
Field Value
DependencyProperty
SelectionBoxStyleProperty
Represents the SelectionBoxStyle dependency property.
Declaration
public static readonly DependencyProperty SelectionBoxStyleProperty
Field Value
DependencyProperty
SelectionBoxStyleSelectorProperty
Represents the SelectionBoxStyleSelector dependency property.
Declaration
public static readonly DependencyProperty SelectionBoxStyleSelectorProperty
Field Value
DependencyProperty
SelectionBoxTemplateProperty
Represents the SelectionBoxTemplate dependency property.
Declaration
public static readonly DependencyProperty SelectionBoxTemplateProperty
Field Value
DependencyProperty
SelectionBoxTemplateSelectorProperty
Represents the SelectionBoxTemplateSelector dependency property.
Declaration
public static readonly DependencyProperty SelectionBoxTemplateSelectorProperty
Field Value
DependencyProperty
SelectionBoxesVisibilityProperty
Represents the SelectionBoxesVisibility dependency property.
Declaration
public static readonly DependencyProperty SelectionBoxesVisibilityProperty
Field Value
DependencyProperty
SelectionBridgeProperty
Represents the SelectionBridge dependency property.
Declaration
public static readonly DependencyProperty SelectionBridgeProperty
Field Value
DependencyProperty
SelectionChangedEvent
Identifies the SelectionChanged routed event.
Declaration
public static readonly RoutedEvent SelectionChangedEvent
Field Value
RoutedEvent
SelectionModeProperty
Represents the SelectionMode dependency property.
Declaration
public static readonly DependencyProperty SelectionModeProperty
Field Value
DependencyProperty
SelectionOnFocusProperty
Identifies the SelectionOnFocus property.
Declaration
public static readonly DependencyProperty SelectionOnFocusProperty
Field Value
DependencyProperty
Properties
AutoCompleteMode
Gets or sets the AutoCompleteMode.
Declaration
public SearchAutoCompleteMode AutoCompleteMode { get; set; }
Property Value
AutoCompleteProvider
Gets or sets the AutoCompleteProvider.
Declaration
public SuggestProvider AutoCompleteProvider { get; set; }
Property Value
CanUserResizeDropDown
Gets or sets a value that indicates whether DropDown popup will be resizable at run-time.
ClearSelectionOnDeleteOrBackKey
Specifies whether the selection should be cleared when the user presses the Delete or Backspace key.
Declaration
public bool ClearSelectionOnDeleteOrBackKey { get; set; }
Property Value
CloseDropDownAfterSelectionInput
Gets or sets a value that indicates whether the drop down should be closed when selection is changed via input.
Declaration
public bool CloseDropDownAfterSelectionInput { get; set; }
Property Value
DeferTextChange
Gets or sets a value that indicates whether text update will be delayed.
DisplayMemberPath
Gets or sets the name or path of the property that is displayed for each data item.
DropDownContentManager
Gets or sets a DropDownContentManager instance that manages interactions with DropDown popup element.
Declaration
public DropDownContentManager DropDownContentManager { get; set; }
Property Value
DropDownElementStyle
Gets or set a Style that is applied to the drop down element. TargetType should match accordingly.
Declaration
public Style DropDownElementStyle { get; set; }
Property Value
Style
DropDownHeight
Gets or sets the DropDown popup height.
DropDownMaxHeight
Gets or sets the DropDown popup maximum height.
DropDownMaxWidth
Gets or sets the DropDown popup maximum width.
DropDownMinHeight
Gets or sets the DropDown popup minimum height.
DropDownMinWidth
Gets or sets the DropDown popup minimum width.
DropDownPlacement
Gets or sets the DropDown placement mode.
Declaration
public PlacementMode DropDownPlacement { get; set; }
Property Value
DropDownWidth
Gets or sets the DropDown popup width.
EditorMinWidth
Gets or sets the minimum width that is set aside for displaying the editor control.
FooterContent
Gets or sets the content displayed in the footer.
FooterContentTemplate
Gets or sets the data template that will be used to display the footer.
Declaration
public DataTemplate FooterContentTemplate { get; set; }
Property Value
DataTemplate
FooterVisibility
Gets or sets a value that indicates whether the footer is visible.
Declaration
public Visibility FooterVisibility { get; set; }
Property Value
Visibility
HighlightMatches
Gets or sets a value that indicates whether matched items will be highlighted.
IsDropDownOpen
Gets a value that indicates whether the DropDownButton popup is open.
IsReadOnly
Gets or sets a value that indicates whether text editor is readonly.
ItemsSourceProvider
Gets or sets an ItemsSourceProvider that handles data binding in the DropDown element.
Declaration
public ItemsSourceProvider ItemsSourceProvider { get; set; }
Property Value
KeepDropDownOpen
Gets or sets a value that indicates whether drop down is closed when its popup loses focus.
MatchCase
Gets or sets value that indicates whether text matching is case sensitive.
NullText
Gets or sets the text that is shown when selection is empty.
OpenDropDownOnFocus
Gets or set a value that indicates whether the drop down button will be expanded when control is focused.
OpenDropDownOnInput
Gets or sets a value that indicates whether drop down gets open when the text field receives text input.
SearchMode
Gets or sets a value that represents the matching behavior when search operation is executed.
SearchStateManager
Gets or sets the SearchStateManager.
Declaration
public SearchStateManager SearchStateManager { get; set; }
Property Value
SelectedIndex
Gets or sets the selected index.
SelectedItem
Gets the currently selected item.
SelectedItems
Gets the currently selected items.
Declaration
public RadObservableCollection<object> SelectedItems { get; }
Property Value
SelectedValue
Gets or sets the selected value.
SelectedValuePath
Gets or sets the property path that is used to get the SelectedValue property of the SelectedItem property.
SelectionBoxStyle
Gets or sets a Style that is used for SearchAutoCompleteBoxItems.
Declaration
public Style SelectionBoxStyle { get; set; }
Property Value
Style
SelectionBoxStyleSelector
Represents the SelectionBoxStyleSelector dependency property.
Declaration
public StyleSelector SelectionBoxStyleSelector { get; set; }
Property Value
StyleSelector
SelectionBoxTemplate
Gets or sets a DataTemplate that is used to display SearchAutoCompleteBoxItems' content.
Declaration
public DataTemplate SelectionBoxTemplate { get; set; }
Property Value
DataTemplate
SelectionBoxTemplateSelector
Gets or sets a DataTemplateSelector that is used to display SearchAutoCompleteBoxItems' content.
Declaration
public DataTemplateSelector SelectionBoxTemplateSelector { get; set; }
Property Value
DataTemplateSelector
SelectionBoxesVisibility
Gets or sets a value that indicates whether selection should be represented with selection boxes.
Declaration
public Visibility SelectionBoxesVisibility { get; set; }
Property Value
Visibility
SelectionBridge
Gets or sets the SelectionBridge.
Declaration
public ISelectionBridge SelectionBridge { get; set; }
Property Value
SelectionMode
Gets or sets the selection mode.
Declaration
public AutoCompleteSelectionMode SelectionMode { get; set; }
Property Value
SelectionOnFocus
Specifies the modification over the selected item text when the control receives focus.
Declaration
public SelectionOnFocus SelectionOnFocus { get; set; }
Property Value
Methods
AssignSelectionBridge(ISelectionBridge)
Initializes a SelectionBridge.
Declaration
protected void AssignSelectionBridge(ISelectionBridge selectionBridge)
Parameters
selectionBridge
ClearSearchText()
Clears the search text.
Declaration
protected void ClearSearchText()
CloseDropDown()
Closes DropDown button.
Declaration
public virtual void CloseDropDown()
OnApplyTemplate()
When overridden in a derived class, is invoked whenever application code or internal processes call .
Declaration
public override void OnApplyTemplate()
OnCreateAutomationPeer()
Creates an appropriate System.Windows.Automation.Peers.ButtonAutomationPeer for this control as part of the WPF infrastructure.
Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
AutomationPeer
OnGotKeyboardFocus(KeyboardFocusChangedEventArgs)
Invoked when an unhandled System.Windows.Input.Keyboard.GotKeyboardFocus attached event reaches an element in its route that is derived from this class.
Declaration
protected override void OnGotKeyboardFocus(KeyboardFocusChangedEventArgs e)
Parameters
e
KeyboardFocusChangedEventArgs
OnInitializeDropDownContentManager(DropDownContentManagerEventArgs)
Raises the InitializeDropDownContentManager event.
Declaration
protected virtual void OnInitializeDropDownContentManager(DropDownContentManagerEventArgs args)
Parameters
args
OnInitializeSelectionBridge(SelectionBridgeEventArgs)
Raises the InitializeSelectionBridge event.
Declaration
protected virtual void OnInitializeSelectionBridge(SelectionBridgeEventArgs args)
Parameters
args
OnInitialized(EventArgs)
Raises the Initialized event.
Declaration
protected override void OnInitialized(EventArgs e)
Parameters
e
OnMouseWheel(MouseWheelEventArgs)
Called before the event occurs to provide handling for the event in a derived class without attaching a delegate.
Declaration
protected override void OnMouseWheel(MouseWheelEventArgs e)
Parameters
e
MouseWheelEventArgs
A MouseWheelEventArgs that contains the event data.
OpenDropDown()
Opens the DropDown button.
Declaration
public virtual void OpenDropDown()
RaiseSelectionChanged(IList<object>, IList<object>)
Raises the SelectionChanged event with the given added and removed items.
ToggleDropDown()
Toggles between DropDown button states.
Declaration
public virtual void ToggleDropDown()
Events
InitializeDropDownContentManager
Event that that is raised when DropDownContentManager is being initialized.
Declaration
public event EventHandler<DropDownContentManagerEventArgs> InitializeDropDownContentManager
Event Value
InitializeSelectionBridge
Event that that is raised when SelectionBridge is being initialized.
Declaration
public event EventHandler<SelectionBridgeEventArgs> InitializeSelectionBridge
Event Value
SelectionChanged
Occurs when the selected items have changed.
Declaration
public event EventHandler<SelectionChangeEventArgs> SelectionChanged
Event Value