Class
RadMultiColumnComboBox

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:

cs-api-definition
[TelerikToolboxCategory("Data")]
public class RadMultiColumnComboBox : Control

Inheritance: objectRadMultiColumnComboBox

Constructors

RadMultiColumnComboBox()

Initializes a new instance of the RadMultiColumnComboBox class.

Declaration

cs-api-definition
public RadMultiColumnComboBox()

Fields

AutoCompleteModeProperty

Represents the AutoCompleteMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoCompleteModeProperty

Field Value

DependencyProperty

AutoCompleteProviderProperty

Represents the AutoCompleteProvider dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoCompleteProviderProperty

Field Value

DependencyProperty

CanUserResizeDropDownProperty

Represents the CanUserResizeDropDown dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CanUserResizeDropDownProperty

Field Value

DependencyProperty

ClearSelectionOnDeleteOrBackKeyProperty

Identifies the ClearSelectionOnDeleteOrBackKey property.

Declaration

cs-api-definition
public static readonly DependencyProperty ClearSelectionOnDeleteOrBackKeyProperty

Field Value

DependencyProperty

CloseDropDownAfterSelectionInputProperty

Represents the CloseDropDownAfterInputSelection dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CloseDropDownAfterSelectionInputProperty

Field Value

DependencyProperty

DeferTextChangeProperty

Represents the DeferTextChange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DeferTextChangeProperty

Field Value

DependencyProperty

DisplayMemberPathProperty

Represents the DisplayMemberPath dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DisplayMemberPathProperty

Field Value

DependencyProperty

DropDownContentManagerProperty

Represents the DropDownContentManager dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownContentManagerProperty

Field Value

DependencyProperty

DropDownElementStyleProperty

Represents the DropDownElementStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownElementStyleProperty

Field Value

DependencyProperty

DropDownHeightProperty

Represents the DropDownHeight dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownHeightProperty

Field Value

DependencyProperty

DropDownMaxHeightProperty

Represents the DropDownMaxHeight dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMaxHeightProperty

Field Value

DependencyProperty

DropDownMaxWidthProperty

Represents the DropDownMaxWidth dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMaxWidthProperty

Field Value

DependencyProperty

DropDownMinHeightProperty

Represents the DropDownMinHeight dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMinHeightProperty

Field Value

DependencyProperty

DropDownMinWidthProperty

Represents the DropDownMinWidth dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownMinWidthProperty

Field Value

DependencyProperty

DropDownPlacementProperty

Represents the DropDownPlacement dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownPlacementProperty

Field Value

DependencyProperty

DropDownWidthProperty

Represents the DropDownWidth dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DropDownWidthProperty

Field Value

DependencyProperty

EditorMinWidthProperty

Represents the EditorMinWidth dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty EditorMinWidthProperty

Field Value

DependencyProperty

FooterContentProperty

Represents the FooterContent dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterContentProperty

Field Value

DependencyProperty

FooterContentTemplateProperty

Represents the FooterContentTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterContentTemplateProperty

Field Value

DependencyProperty

FooterVisibilityProperty

Represents the FooterVisibility dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterVisibilityProperty

Field Value

DependencyProperty

HighlightMatchesProperty

Represents the HighlightMatches dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HighlightMatchesProperty

Field Value

DependencyProperty

IsReadOnlyProperty

Represents the IsReadOnly dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsReadOnlyProperty

Field Value

DependencyProperty

ItemsSourceProviderProperty

Represents the ItemsSourceProvider dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ItemsSourceProviderProperty

Field Value

DependencyProperty

KeepDropDownOpenProperty

Represents the KeepDropDownOpen dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty KeepDropDownOpenProperty

Field Value

DependencyProperty

MatchCaseProperty

Represents the MatchCase dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MatchCaseProperty

Field Value

DependencyProperty

NullTextProperty

Represents the NullText dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty NullTextProperty

Field Value

DependencyProperty

OpenDropDownOnFocusProperty

Represents the OpenDropDownOnFocus dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OpenDropDownOnFocusProperty

Field Value

DependencyProperty

OpenDropDownOnInputProperty

Represents the OpenDropDownOnInput dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OpenDropDownOnInputProperty

Field Value

DependencyProperty

SearchModeProperty

Identifies the SearchMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SearchModeProperty

Field Value

DependencyProperty

SearchStateManagerProperty

Represents the SearchStateManager dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SearchStateManagerProperty

Field Value

DependencyProperty

SelectedIndexProperty

Represents the SelectedIndex dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedIndexProperty

Field Value

DependencyProperty

SelectedItemProperty

Represents the SelectedItem dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedItemProperty

Field Value

DependencyProperty

SelectedItemsProperty

Represents the SelectedItems dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedItemsProperty

Field Value

DependencyProperty

SelectedValuePathProperty

Represents the SelectedValuePath dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedValuePathProperty

Field Value

DependencyProperty

SelectedValueProperty

Represents the SelectedValue dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectedValueProperty

Field Value

DependencyProperty

SelectionBoxStyleProperty

Represents the SelectionBoxStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBoxStyleProperty

Field Value

DependencyProperty

SelectionBoxStyleSelectorProperty

Represents the SelectionBoxStyleSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBoxStyleSelectorProperty

Field Value

DependencyProperty

SelectionBoxTemplateProperty

Represents the SelectionBoxTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBoxTemplateProperty

Field Value

DependencyProperty

SelectionBoxTemplateSelectorProperty

Represents the SelectionBoxTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBoxTemplateSelectorProperty

Field Value

DependencyProperty

SelectionBoxesVisibilityProperty

Represents the SelectionBoxesVisibility dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBoxesVisibilityProperty

Field Value

DependencyProperty

SelectionBridgeProperty

Represents the SelectionBridge dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionBridgeProperty

Field Value

DependencyProperty

SelectionChangedEvent

Identifies the SelectionChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent SelectionChangedEvent

Field Value

RoutedEvent

SelectionModeProperty

Represents the SelectionMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionModeProperty

Field Value

DependencyProperty

SelectionOnFocusProperty

Identifies the SelectionOnFocus property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectionOnFocusProperty

Field Value

DependencyProperty

Properties

AutoCompleteMode

Gets or sets the AutoCompleteMode.

Declaration

cs-api-definition
public SearchAutoCompleteMode AutoCompleteMode { get; set; }

Property Value

SearchAutoCompleteMode

AutoCompleteProvider

Gets or sets the AutoCompleteProvider.

Declaration

cs-api-definition
public SuggestProvider AutoCompleteProvider { get; set; }

Property Value

SuggestProvider

CanUserResizeDropDown

Gets or sets a value that indicates whether DropDown popup will be resizable at run-time.

Declaration

cs-api-definition
public bool CanUserResizeDropDown { get; set; }

Property Value

bool

ClearSelectionOnDeleteOrBackKey

Specifies whether the selection should be cleared when the user presses the Delete or Backspace key.

Declaration

cs-api-definition
public bool ClearSelectionOnDeleteOrBackKey { get; set; }

Property Value

bool

CloseDropDownAfterSelectionInput

Gets or sets a value that indicates whether the drop down should be closed when selection is changed via input.

Declaration

cs-api-definition
public bool CloseDropDownAfterSelectionInput { get; set; }

Property Value

bool

DeferTextChange

Gets or sets a value that indicates whether text update will be delayed.

Declaration

cs-api-definition
public bool DeferTextChange { get; set; }

Property Value

bool

DisplayMemberPath

Gets or sets the name or path of the property that is displayed for each data item.

Declaration

cs-api-definition
public string DisplayMemberPath { get; set; }

Property Value

string

DropDownContentManager

Gets or sets a DropDownContentManager instance that manages interactions with DropDown popup element.

Declaration

cs-api-definition
public DropDownContentManager DropDownContentManager { get; set; }

Property Value

DropDownContentManager

DropDownElementStyle

Gets or set a Style that is applied to the drop down element. TargetType should match accordingly.

Declaration

cs-api-definition
public Style DropDownElementStyle { get; set; }

Property Value

Style

DropDownHeight

Gets or sets the DropDown popup height.

Declaration

cs-api-definition
public double DropDownHeight { get; set; }

Property Value

double

DropDownMaxHeight

Gets or sets the DropDown popup maximum height.

Declaration

cs-api-definition
public double DropDownMaxHeight { get; set; }

Property Value

double

DropDownMaxWidth

Gets or sets the DropDown popup maximum width.

Declaration

cs-api-definition
public double DropDownMaxWidth { get; set; }

Property Value

double

DropDownMinHeight

Gets or sets the DropDown popup minimum height.

Declaration

cs-api-definition
public double DropDownMinHeight { get; set; }

Property Value

double

DropDownMinWidth

Gets or sets the DropDown popup minimum width.

Declaration

cs-api-definition
public double DropDownMinWidth { get; set; }

Property Value

double

DropDownPlacement

Gets or sets the DropDown placement mode.

Declaration

cs-api-definition
public PlacementMode DropDownPlacement { get; set; }

Property Value

PlacementMode

DropDownWidth

Gets or sets the DropDown popup width.

Declaration

cs-api-definition
public double DropDownWidth { get; set; }

Property Value

double

EditorMinWidth

Gets or sets the minimum width that is set aside for displaying the editor control.

Declaration

cs-api-definition
public double EditorMinWidth { get; set; }

Property Value

double

FooterContent

Gets or sets the content displayed in the footer.

Declaration

cs-api-definition
public object FooterContent { get; set; }

Property Value

object

FooterContentTemplate

Gets or sets the data template that will be used to display the footer.

Declaration

cs-api-definition
public DataTemplate FooterContentTemplate { get; set; }

Property Value

DataTemplate

FooterVisibility

Gets or sets a value that indicates whether the footer is visible.

Declaration

cs-api-definition
public Visibility FooterVisibility { get; set; }

Property Value

Visibility

HighlightMatches

Gets or sets a value that indicates whether matched items will be highlighted.

Declaration

cs-api-definition
public bool HighlightMatches { get; set; }

Property Value

bool

IsDropDownOpen

Gets a value that indicates whether the DropDownButton popup is open.

Declaration

cs-api-definition
public bool IsDropDownOpen { get; }

Property Value

bool

IsReadOnly

Gets or sets a value that indicates whether text editor is readonly.

Declaration

cs-api-definition
public bool IsReadOnly { get; set; }

Property Value

bool

ItemsSourceProvider

Gets or sets an ItemsSourceProvider that handles data binding in the DropDown element.

Declaration

cs-api-definition
public ItemsSourceProvider ItemsSourceProvider { get; set; }

Property Value

ItemsSourceProvider

KeepDropDownOpen

Gets or sets a value that indicates whether drop down is closed when its popup loses focus.

Declaration

cs-api-definition
public bool KeepDropDownOpen { get; set; }

Property Value

bool

MatchCase

Gets or sets value that indicates whether text matching is case sensitive.

Declaration

cs-api-definition
public bool MatchCase { get; set; }

Property Value

bool

NullText

Gets or sets the text that is shown when selection is empty.

Declaration

cs-api-definition
public string NullText { get; set; }

Property Value

string

OpenDropDownOnFocus

Gets or set a value that indicates whether the drop down button will be expanded when control is focused.

Declaration

cs-api-definition
public bool OpenDropDownOnFocus { get; set; }

Property Value

bool

OpenDropDownOnInput

Gets or sets a value that indicates whether drop down gets open when the text field receives text input.

Declaration

cs-api-definition
public bool OpenDropDownOnInput { get; set; }

Property Value

bool

SearchMode

Gets or sets a value that represents the matching behavior when search operation is executed.

Declaration

cs-api-definition
public SearchMode SearchMode { get; set; }

Property Value

SearchMode

SearchStateManager

Gets or sets the SearchStateManager.

Declaration

cs-api-definition
public SearchStateManager SearchStateManager { get; set; }

Property Value

SearchStateManager

SelectedIndex

Gets or sets the selected index.

Declaration

cs-api-definition
public int SelectedIndex { get; set; }

Property Value

int

SelectedItem

Gets the currently selected item.

Declaration

cs-api-definition
public object SelectedItem { get; set; }

Property Value

object

SelectedItems

Gets the currently selected items.

Declaration

cs-api-definition
public RadObservableCollection<object> SelectedItems { get; }

Property Value

RadObservableCollection<object>

SelectedValue

Gets or sets the selected value.

Declaration

cs-api-definition
public object SelectedValue { get; set; }

Property Value

object

SelectedValuePath

Gets or sets the property path that is used to get the SelectedValue property of the SelectedItem property.

Declaration

cs-api-definition
public string SelectedValuePath { get; set; }

Property Value

string

SelectionBoxStyle

Gets or sets a Style that is used for SearchAutoCompleteBoxItems.

Declaration

cs-api-definition
public Style SelectionBoxStyle { get; set; }

Property Value

Style

SelectionBoxStyleSelector

Represents the SelectionBoxStyleSelector dependency property.

Declaration

cs-api-definition
public StyleSelector SelectionBoxStyleSelector { get; set; }

Property Value

StyleSelector

SelectionBoxTemplate

Gets or sets a DataTemplate that is used to display SearchAutoCompleteBoxItems' content.

Declaration

cs-api-definition
public DataTemplate SelectionBoxTemplate { get; set; }

Property Value

DataTemplate

SelectionBoxTemplateSelector

Gets or sets a DataTemplateSelector that is used to display SearchAutoCompleteBoxItems' content.

Declaration

cs-api-definition
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

cs-api-definition
public Visibility SelectionBoxesVisibility { get; set; }

Property Value

Visibility

SelectionBridge

Gets or sets the SelectionBridge.

Declaration

cs-api-definition
public ISelectionBridge SelectionBridge { get; set; }

Property Value

ISelectionBridge

SelectionMode

Gets or sets the selection mode.

Declaration

cs-api-definition
public AutoCompleteSelectionMode SelectionMode { get; set; }

Property Value

AutoCompleteSelectionMode

SelectionOnFocus

Specifies the modification over the selected item text when the control receives focus.

Declaration

cs-api-definition
public SelectionOnFocus SelectionOnFocus { get; set; }

Property Value

SelectionOnFocus

Methods

AssignSelectionBridge(ISelectionBridge)

Initializes a SelectionBridge.

Declaration

cs-api-definition
protected void AssignSelectionBridge(ISelectionBridge selectionBridge)

Parameters

selectionBridge

ISelectionBridge

ClearSearchText()

Clears the search text.

Declaration

cs-api-definition
protected void ClearSearchText()

CloseDropDown()

Closes DropDown button.

Declaration

cs-api-definition
public virtual void CloseDropDown()

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call .

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates an appropriate System.Windows.Automation.Peers.ButtonAutomationPeer for this control as part of the WPF infrastructure.

Declaration

cs-api-definition
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

cs-api-definition
protected override void OnGotKeyboardFocus(KeyboardFocusChangedEventArgs e)

Parameters

e

KeyboardFocusChangedEventArgs

OnInitializeDropDownContentManager(DropDownContentManagerEventArgs)

Raises the InitializeDropDownContentManager event.

Declaration

cs-api-definition
protected virtual void OnInitializeDropDownContentManager(DropDownContentManagerEventArgs args)

Parameters

args

DropDownContentManagerEventArgs

OnInitializeSelectionBridge(SelectionBridgeEventArgs)

Raises the InitializeSelectionBridge event.

Declaration

cs-api-definition
protected virtual void OnInitializeSelectionBridge(SelectionBridgeEventArgs args)

Parameters

args

SelectionBridgeEventArgs

OnInitialized(EventArgs)

Raises the Initialized event.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

OnMouseWheel(MouseWheelEventArgs)

Called before the event occurs to provide handling for the event in a derived class without attaching a delegate.

Declaration

cs-api-definition
protected override void OnMouseWheel(MouseWheelEventArgs e)

Parameters

e

MouseWheelEventArgs

A MouseWheelEventArgs that contains the event data.

OpenDropDown()

Opens the DropDown button.

Declaration

cs-api-definition
public virtual void OpenDropDown()

RaiseSelectionChanged(IList<object>, IList<object>)

Raises the SelectionChanged event with the given added and removed items.

Declaration

cs-api-definition
protected void RaiseSelectionChanged(IList<object> addedItems, IList<object> removedItems)

Parameters

addedItems

IList<object>

removedItems

IList<object>

ResetTheme()

Resets the theme.

Declaration

cs-api-definition
public void ResetTheme()

ToggleDropDown()

Toggles between DropDown button states.

Declaration

cs-api-definition
public virtual void ToggleDropDown()

Events

InitializeDropDownContentManager

Event that that is raised when DropDownContentManager is being initialized.

Declaration

cs-api-definition
public event EventHandler<DropDownContentManagerEventArgs> InitializeDropDownContentManager

Event Value

EventHandler<DropDownContentManagerEventArgs>

InitializeSelectionBridge

Event that that is raised when SelectionBridge is being initialized.

Declaration

cs-api-definition
public event EventHandler<SelectionBridgeEventArgs> InitializeSelectionBridge

Event Value

EventHandler<SelectionBridgeEventArgs>

SelectionChanged

Occurs when the selected items have changed.

Declaration

cs-api-definition
public event EventHandler<SelectionChangeEventArgs> SelectionChanged

Event Value

EventHandler<SelectionChangeEventArgs>

In this article
DefinitionConstructorsRadMultiColumnComboBox()FieldsAutoCompleteModePropertyAutoCompleteProviderPropertyCanUserResizeDropDownPropertyClearSelectionOnDeleteOrBackKeyPropertyCloseDropDownAfterSelectionInputPropertyDeferTextChangePropertyDisplayMemberPathPropertyDropDownContentManagerPropertyDropDownElementStylePropertyDropDownHeightPropertyDropDownMaxHeightPropertyDropDownMaxWidthPropertyDropDownMinHeightPropertyDropDownMinWidthPropertyDropDownPlacementPropertyDropDownWidthPropertyEditorMinWidthPropertyFooterContentPropertyFooterContentTemplatePropertyFooterVisibilityPropertyHighlightMatchesPropertyIsReadOnlyPropertyItemsSourceProviderPropertyKeepDropDownOpenPropertyMatchCasePropertyNullTextPropertyOpenDropDownOnFocusPropertyOpenDropDownOnInputPropertySearchModePropertySearchStateManagerPropertySelectedIndexPropertySelectedItemPropertySelectedItemsPropertySelectedValuePathPropertySelectedValuePropertySelectionBoxStylePropertySelectionBoxStyleSelectorPropertySelectionBoxTemplatePropertySelectionBoxTemplateSelectorPropertySelectionBoxesVisibilityPropertySelectionBridgePropertySelectionChangedEventSelectionModePropertySelectionOnFocusPropertyPropertiesAutoCompleteModeAutoCompleteProviderCanUserResizeDropDownClearSelectionOnDeleteOrBackKeyCloseDropDownAfterSelectionInputDeferTextChangeDisplayMemberPathDropDownContentManagerDropDownElementStyleDropDownHeightDropDownMaxHeightDropDownMaxWidthDropDownMinHeightDropDownMinWidthDropDownPlacementDropDownWidthEditorMinWidthFooterContentFooterContentTemplateFooterVisibilityHighlightMatchesIsDropDownOpenIsReadOnlyItemsSourceProviderKeepDropDownOpenMatchCaseNullTextOpenDropDownOnFocusOpenDropDownOnInputSearchModeSearchStateManagerSelectedIndexSelectedItemSelectedItemsSelectedValueSelectedValuePathSelectionBoxStyleSelectionBoxStyleSelectorSelectionBoxTemplateSelectionBoxTemplateSelectorSelectionBoxesVisibilitySelectionBridgeSelectionModeSelectionOnFocusMethodsAssignSelectionBridge(ISelectionBridge)ClearSearchText()CloseDropDown()OnApplyTemplate()OnCreateAutomationPeer()OnGotKeyboardFocus(KeyboardFocusChangedEventArgs)OnInitializeDropDownContentManager(DropDownContentManagerEventArgs)OnInitializeSelectionBridge(SelectionBridgeEventArgs)OnInitialized(EventArgs)OnMouseWheel(MouseWheelEventArgs)OpenDropDown()RaiseSelectionChanged(IList<object>, IList<object>)ResetTheme()ToggleDropDown()EventsInitializeDropDownContentManagerInitializeSelectionBridgeSelectionChanged
Not finding the help you need?
Contact Support