In This Article

BarComboBoxViewModel Class

Represents a view model for a combobox control within a bar control.

public class BarComboBoxViewModel : BarGalleryViewModel, IHasKey, IHasVariantImages
Inheritance:
object ObservableObjectBase BarKeyedObjectViewModelBase BarGalleryViewModelBase BarGalleryViewModel object
Implements:
IHasKey IHasVariantImages

Constructors

BarComboBoxViewModel()

Initializes a new instance of the class.

public BarComboBoxViewModel()

BarComboBoxViewModel(string?)

Initializes a new instance of the class with the specified key. The label and key tip text are auto-generated.

public BarComboBoxViewModel(string? key)
Parameter Type Description
key string

A string that uniquely identifies the control.

BarComboBoxViewModel(string?, IEnumerable?)

Initializes a new instance of the class with the specified key and items. The label and key tip text are auto-generated.

public BarComboBoxViewModel(string? key, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

BarComboBoxViewModel(string?, string?)

Initializes a new instance of the class with the specified key and label. The key tip text is auto-generated.

public BarComboBoxViewModel(string? key, string? label)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the key if null.

BarComboBoxViewModel(string?, string?, IEnumerable?)

Initializes a new instance of the class with the specified key, label, and items. The key tip text is auto-generated.

public BarComboBoxViewModel(string? key, string? label, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the key if null.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

BarComboBoxViewModel(string?, string?, string?)

Initializes a new instance of the class with the specified key, label, and key tip text.

public BarComboBoxViewModel(string? key, string? label, string? keyTipText)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the key if null.

keyTipText string

The key tip text, which is auto-generated from the label if null.

BarComboBoxViewModel(string?, string?, string?, IEnumerable?)

Initializes a new instance of the class with the specified key, label, key tip text, and items.

public BarComboBoxViewModel(string? key, string? label, string? keyTipText, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the key if null.

keyTipText string

The key tip text, which is auto-generated from the label if null.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

BarComboBoxViewModel(string?, string?, string?, ICommand?)

Initializes a new instance of the class with the specified key, label, key tip text, and command.

public BarComboBoxViewModel(string? key, string? label, string? keyTipText, ICommand? command)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the command or key if null.

keyTipText string

The key tip text, which is auto-generated from the command or label if null.

command ICommand

The command to attach to the control.

BarComboBoxViewModel(string?, string?, string?, ICommand?, IEnumerable?)

Initializes a new instance of the class with the specified key, label, key tip text, command, and items.

public BarComboBoxViewModel(string? key, string? label, string? keyTipText, ICommand? command, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the command or key if null.

keyTipText string

The key tip text, which is auto-generated from the command or label if null.

command ICommand

The command to attach to the control.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

BarComboBoxViewModel(string?, string?, ICommand?)

Initializes a new instance of the class with the specified key, label, and command. The key tip text is auto-generated.

public BarComboBoxViewModel(string? key, string? label, ICommand? command)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the command or key if null.

command ICommand

The command to attach to the control.

BarComboBoxViewModel(string?, string?, ICommand?, IEnumerable?)

Initializes a new instance of the class with the specified key, label, command, and items. The key tip text is auto-generated.

public BarComboBoxViewModel(string? key, string? label, ICommand? command, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

label string

The text label to display, which is auto-generated from the command or key if null.

command ICommand

The command to attach to the control.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

BarComboBoxViewModel(string?, ICommand?)

Initializes a new instance of the class with the specified key and command. The label and key tip text are auto-generated.

public BarComboBoxViewModel(string? key, ICommand? command)
Parameter Type Description
key string

A string that uniquely identifies the control.

command ICommand

The command to attach to the control.

BarComboBoxViewModel(string?, ICommand?, IEnumerable?)

Initializes a new instance of the class with the specified key, command, and items. The label and key tip text are auto-generated.

public BarComboBoxViewModel(string? key, ICommand? command, IEnumerable? items)
Parameter Type Description
key string

A string that uniquely identifies the control.

command ICommand

The command to attach to the control.

items IEnumerable

The collection of gallery items, where the items are typically of type IBarGalleryItemViewModel.

Properties

Description

The text description to display in screen tips.

public string? Description { get; set; }

Property Value

string

IsEditable

Indictes whether the combobox is editable.

public bool IsEditable { get; set; }

Property Value

bool:

The default value is false.

IsPreviewEnabledWhenPopupClosed

Indicates whether an editable combobox will preview a gallery item if the item is matched by typed text while the popup is closed.

public bool IsPreviewEnabledWhenPopupClosed { get; set; }

Property Value

bool:

The default value is false.

IsReadOnly

Indicates whether the combobox is read-only.

public bool IsReadOnly { get; set; }

Property Value

bool:

The default value is false.

IsStarSizingAllowed

Indicates whether the control can star-size and fill available space when appropriate.

public bool IsStarSizingAllowed { get; set; }

Property Value

bool:

The default value is false.

IsTextCompletionEnabled

Indicates whether the control will attempt to complete typed text with a matching item.

public bool IsTextCompletionEnabled { get; set; }

Property Value

bool:

The default value is true.

IsTextSearchCaseSensitive

Indicates whether case is a condition when searching for items.

public bool IsTextSearchCaseSensitive { get; set; }

Property Value

bool:

true if text searches are case-sensitive; otherwise false. The default value is false.

See Also

IsTextSearchEnabled

Indicates whether known items are matched when text is entered.

public bool IsTextSearchEnabled { get; set; }

Property Value

bool:

The default value is true.

See Also

IsUnmatchedTextAllowed

Indicates whether committed Text that is unable to be matched to a gallery item will raise the UnmatchedTextCommand and possibly be allowed.

public bool IsUnmatchedTextAllowed { get; set; }

Property Value

bool:

The default value is true.

See Also

MaxPopupHeight

The maximum popup height.

public double MaxPopupHeight { get; set; }

Property Value

double:

The default value is Double.PositiveInfinity.

PlaceholderText

The placeholder text to display when the control is empty.

public string? PlaceholderText { get; set; }

Property Value

string

RequestedWidth

The requested width of the control.

public double RequestedWidth { get; set; }

Property Value

double:

The default value is 110.

Text

The text to display in the control.

public string Text { get; set; }

Property Value

string

UnmatchedTextCommand

The ICommand to execute when Text is committed that is unable to be matched to a gallery item or when IsTextSearchEnabled is false.

public ICommand? UnmatchedTextCommand { get; set; }

Property Value

ICommand

Remarks

This command is only used when the IsUnmatchedTextAllowed property is true. The unmatched text string is passed as a command parameter.

When the command is null or CanExecute(object) returns true, the text will be committed; otherwise, it will not be committed.

See Also

Methods

SelectItemByTextMatch<T>(Func<T, string>, string)

Selects an item in the gallery whose text representation matches the specified text,

public virtual T? SelectItemByTextMatch<T>(Func<T, string> getItemTextFunc, string text) where T : IBarGalleryItemViewModel
Type Parameters:
T -

The type of IBarGalleryItemViewModel to examine.

Parameter Type Description
getItemTextFunc Func<T, string>

A function that examines an item and returns its string value for comparison to text.

text string

The text for which to search and that will be set to Text.

Returns

T:

The IBarGalleryItemViewModel that was selected, if any.

SelectItemByValueMatch<T>(Func<T, bool>, Func<T, string>, string)

Selects an item in the gallery that matches the predicate, alternatively setting the specified fallback Text if no match is made.

public virtual T? SelectItemByValueMatch<T>(Func<T, bool> matchPredicate, Func<T, string> getMatchedItemTextFunc, string fallbackText) where T : IBarGalleryItemViewModel
Type Parameters:
T -

The type of IBarGalleryItemViewModel to examine.

Parameter Type Description
matchPredicate Func<T, bool>

A predicate that determines when an item matches criteria.

getMatchedItemTextFunc Func<T, string>

A function that examines a matched item and returns the string value to set to Text.

fallbackText string

The fallback text to set to Text when there is no match.

Returns

T:

The IBarGalleryItemViewModel that was selected, if any.

Inherited Members

Extension Methods