RadComboBox

Gets or sets the command that clears the current selection, setting SelectedItem to null and clearing SelectedItems. This command is typically bound to a clear button or used programmatically to reset the selection state.

public ICommand ClearSelectionCommand { get; set; }

ControlTemplate

Gets or sets the control template of this view.

public ControlTemplate ControlTemplate { get; set; }

DisplayMemberPath

Gets or sets the property path used to determine which property of the data object should be displayed in the dropdown items. Use "." to display the object itself, or specify a property name like "Name" or "Title" to display a specific property.

public string DisplayMemberPath { get; set; }

DropDownBackgroundColor

Color

Gets or sets the background color of the drop down part of the control.

public Color DropDownBackgroundColor { get; set; }

DropDownBorderColor

Color

Gets or sets the color of the border around the drop down part of the control.

public Color DropDownBorderColor { get; set; }

DropDownBorderThickness

Thickness

Gets or sets the thickness of the border that is around the drop down part of the control.

public Thickness DropDownBorderThickness { get; set; }

DropDownButtonStyle

Style

Gets or sets the Style of the drop down button.

public Style DropDownButtonStyle { get; set; }

DropDownCornerRadius

Thickness

Gets or sets the corner radius of the border that is around the drop down part of the control.

public Thickness DropDownCornerRadius { get; set; }

DropDownHeight

Gets or sets the fixed height of the dropdown area in device-independent units. If not set or set to a negative value, the dropdown will size itself based on its content up to DropDownMaxHeight.

public double DropDownHeight { get; set; }

DropDownMaxHeight

Gets or sets the maximum height of the dropdown area in device-independent units. This property constrains the dropdown height when it auto-sizes based on content, ensuring it doesn't exceed the specified limit.

public double DropDownMaxHeight { get; set; }

DropDownVerticalOffset

Gets or sets the vertical offset of the drop down part of the control.

public double DropDownVerticalOffset { get; set; }

DropDownWidth

IReadOnlyCollection<object>

Gets or sets the width of the dropdown area in device-independent units. If not set, the dropdown will match the width of the ComboBox control itself.

public double DropDownWidth { get; set; }

FilteredItems

Gets the collection of items that match the current filter criteria when IsFilteringEnabled is true. This read-only collection is automatically updated as the user types and the filtering logic is applied.

public IReadOnlyCollection<object> FilteredItems { get; }

FilteringBehavior

ComboBoxFilteringBehavior

Gets or sets the custom filtering behavior used to filter items based on user input. This allows you to implement custom filtering logic beyond the built-in SearchMode options.

public ComboBoxFilteringBehavior FilteringBehavior { get; set; }

FontAttributes

Gets or sets values that describe font styles.

public FontAttributes FontAttributes { get; set; }

FontFamily

Gets or sets the font family to which the font belongs.

public string FontFamily { get; set; }

FooterTemplate

DataTemplate

Gets or sets the template used to display the footer content at the bottom of the dropdown list. This template is rendered below all dropdown items and can contain any content or controls.

public DataTemplate FooterTemplate { get; set; }

HeaderTemplate

DataTemplate

Gets or sets the template used to display the header content at the top of the dropdown list. This template is rendered above all dropdown items and can contain any content or controls.

public DataTemplate HeaderTemplate { get; set; }

HighlightTextColor

Color

Gets or sets the color used to highlight the matched text portions when filtering is active. This provides visual feedback to users showing which parts of the item text match their search input.

public Color HighlightTextColor { get; set; }

IsClearButtonVisible

Gets or sets a value indicating if the clear button should be visible.

public bool IsClearButtonVisible { get; set; }

Remarks:

When False Clear button will never be visible. Otherwise it will be visible only when control is focused.

IsDropDownClosedOnSelection

Gets or sets a value indicating whether the dropdown should automatically close when an item is selected or deselected. When false, the dropdown remains open after selection, allowing for easier multiple selection.

public bool IsDropDownClosedOnSelection { get; set; }

IsDropDownOpen

Gets or sets a value indicating whether the drop down part of the control is opened.

public bool IsDropDownOpen { get; set; }

IsEditable

Gets or sets a value indicating whether the ComboBox allows direct text input and editing. When true, users can type text directly into the control to search and filter items. When false, users can only select from the dropdown list.

public bool IsEditable { get; set; }

IsFilteringEnabled

Gets or sets a value indicating whether filtering of dropdown items is enabled when the user types in the ComboBox. When true and IsEditable is also true, the dropdown list will be filtered based on user input.

public bool IsFilteringEnabled { get; set; }

IsSpellCheckEnabled

Gets or sets a value that controls whether spell checking is enabled.

public bool IsSpellCheckEnabled { get; set; }

ItemsSource

IEnumerable

Gets or sets the collection of data items that populate the ComboBox dropdown list. This can be any object that implements IEnumerable, such as a list, array, or observable collection.

public IEnumerable ItemsSource { get; set; }

ItemTemplate

DataTemplate

Gets or sets the template used to display each item in the dropdown list. This template defines how individual data items are rendered when the dropdown is open.

public DataTemplate ItemTemplate { get; set; }

Keyboard

Gets or sets the keyboard type of the entry part of the control.

public Keyboard Keyboard { get; set; }

KeyDownCommand

Gets or sets the command that is invoked when a key is pressed. The parameter of this command is of type KeyboardInfo.

public ICommand KeyDownCommand { get; set; }

NoResultsMessage

Gets or sets the message text displayed when no items match the current filter criteria. This provides a simple text alternative to NoResultsTemplate for informing users about empty search results.

public string NoResultsMessage { get; set; }

NoResultsTemplate

DataTemplate

Gets or sets the template displayed when no items match the current filter criteria. This provides a customizable way to inform users that their search didn't return any results.

public DataTemplate NoResultsTemplate { get; set; }

OpenOnFocus

Gets or sets a value indicating whether the dropdown should automatically open when the ComboBox receives focus. This property only applies when IsEditable is set to true.

public bool OpenOnFocus { get; set; }

Placeholder

Gets or sets the placeholder text displayed when the ComboBox is empty and not focused. This provides guidance to users about what they should enter or select.

public string Placeholder { get; set; }

PlaceholderColor

Color

Gets or sets the color of the placeholder text displayed when the ComboBox is empty. This allows customization of the placeholder text appearance to match your application's theme.

public Color PlaceholderColor { get; set; }

RemoveTokenCommand

Gets or sets the command that removes individual selection tokens when SelectionMode is set to Multiple. This command is typically executed when users click the remove button on individual tokens. The parameter of this command is a selected business item, i.e. an item from the SelectedItems.

public ICommand RemoveTokenCommand { get; set; }

SearchMode

Gets or sets the search criteria mode used when filtering items in the dropdown. This determines how the user's input text is matched against the items (starts with, contains, case-sensitive options).

public SearchMode SearchMode { get; set; }

SearchText

Gets the current search text entered by the user when IsEditable is true. This property reflects the text used for filtering and searching within the dropdown items.

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

SearchTextPath

Gets or sets the property path used to determine which property of the data object should be used for searching and filtering. Use "." to search against the object itself, or specify a property name like "Name" to search against a specific property.

public string SearchTextPath { get; set; }

SelectAllCommand

ObservableCollection<object>

Gets the command that selects all available items from the ItemsSource when SelectionMode is set to Multiple. This read-only command is automatically created and can be used to provide "select all" functionality.

public ICommand SelectAllCommand { get; }

SelectedIndex

int

Gets or sets the zero-based index of the currently selected item in the ItemsSource. When SelectionMode is Single, this represents the selected item's index. When Multiple, this represents the first selected item's index or -1 if no items are selected.

public int SelectedIndex { get; set; }

SelectedItem

object

Gets or sets the currently selected item from the ItemsSource. When SelectionMode is Single, this represents the selected item. When Multiple, this represents the first selected item or null if no items are selected.

public object SelectedItem { get; set; }

SelectedItems

Gets the collection of all currently selected items from the ItemsSource. This collection is automatically maintained and reflects the current selection state. It's particularly useful when SelectionMode is set to Multiple.

public ObservableCollection<object> SelectedItems { get; }

SelectedItemTemplate

DataTemplate

Gets or sets the template used to display selected items when they appear in the dropdown list. This template is typically used to provide visual indication that an item is selected, often through different styling or checkmarks.

public DataTemplate SelectedItemTemplate { get; set; }

SelectionBoxTemplate

DataTemplate

Gets or sets the template used to display the selected item in the selection box when the ComboBox is not editable. This template is only used when IsEditable is set to false and defines how the selected item appears in the collapsed state.

public DataTemplate SelectionBoxTemplate { get; set; }

SelectionMode

ComboBoxSelectionMode

Gets or sets the selection mode that determines how users can select items from the dropdown. Use Single for single-item selection or Multiple to allow selection of multiple items with tokens.

public ComboBoxSelectionMode SelectionMode { get; set; }

ShowMoreTemplate

DataTemplate

Gets or sets the template used to display the "show more" indicator when there are more selected tokens than can be displayed in the available space. This template appears when multiple items are selected and the ComboBox is not focused, providing a way to indicate additional selections.

public DataTemplate ShowMoreTemplate { get; set; }

Style

Gets or sets the Style of the control.

public Style Style { get; set; }

Text

Gets or sets the text content displayed in the ComboBox. When IsEditable is true, this represents the user-entered text. When false, this displays the text representation of the selected item.

public string Text { get; set; }

TextColor

Color

Gets or sets the TextColor of the component.

public Color TextColor { get; set; }

Property Value:

The Color.

TextInputStyle

Style

Gets or sets the style of the inner RadTextInput.

public Style TextInputStyle { get; set; }

TokenTemplate

DataTemplate

Gets or sets the template used to display individual selection tokens when SelectionMode is set to Multiple. Each selected item is represented as a token that can be styled and customized through this template.

public DataTemplate TokenTemplate { get; set; }

Methods

Focus()

Attempts to set focus to this element.

public bool Focus()

Returns: