ComboBoxBase Class

public abstract class ComboBoxBase : ComboBox, IKeyTipTarget, IVariantControl

protected ComboBoxBase()

protected virtual bool CanUpdateCanExecuteWhenHidden { get; }

Property Value

bool:

true if the control gets its UpdateCanExecute() method called even when it is hidden; otherwise, false.

public ICommand Command { get; set; }

Property Value

ICommand:

The ICommand that is attached to the control.

public object CommandParameter { get; set; }

Property Value

object:

A user defined data value that can be passed to the Command when it is executed.

public IInputElement CommandTarget { get; set; }

Property Value

IInputElement:

The object that the command is being executed on.

public ControlContext Context { get; set; }

Property Value

ControlContext:

A ControlContext that describes the current context of the control.

public bool HasImage { get; }

Property Value

bool:

true if the control has an image available for display; otherwise, false.

public bool HasLabel { get; }

Property Value

bool:

true if the control has a label available for display; otherwise, false.

[Localizability(LocalizationCategory.Label)]
public object Hint { get; set; }

Property Value

object:

The hint to display when the combobox is empty.

public DataTemplate HintTemplate { get; set; }

Property Value

DataTemplate:

A data template used to display the hint of the combobox.

public DataTemplateSelector HintTemplateSelector { get; set; }

Property Value

DataTemplateSelector:

A data template selector that enables an application writer to provide custom template-selection logic for the hint.

[Localizability(LocalizationCategory.NeverLocalize)]
public string Id { get; set; }

Property Value

string:

The control ID, which can be used to identify the control.

Remarks

When two controls of the same type have the same ID, they are considered the same for Quick Access ToolBar (QAT) customization purposes.

public ImageSource ImageSourceLarge { get; set; }

Property Value

ImageSource:

The ImageSource for the 32x32 image to display for the control.

public ImageSource ImageSourceSmall { get; set; }

Property Value

ImageSource:

The ImageSource for the 16x16 image to display for the control.

public bool IsHighlighted { get; set; }

Property Value

bool:

true if the control is currently highlighted in a menu; otherwise, false.

public bool IsPointerOver { get; }

Property Value

bool:

true if the mouse is truly over the control; otherwise, false.

[Localizability(LocalizationCategory.Text)]
public string KeyTipAccessText { get; set; }

Property Value

string:

The key tip access text for the control.

[Localizability(LocalizationCategory.Label)]
public string Label { get; set; }

Property Value

string:

The text label to display for the control.

[Localizability(LocalizationCategory.ToolTip)]
public object ScreenTipDescription { get; set; }

Property Value

object:

The description object that will be displayed in screen tips for the control.

[Localizability(LocalizationCategory.ToolTip)]
public object ScreenTipFooter { get; set; }

Property Value

object:

The footer object that will be displayed in screen tips for the control.

[Localizability(LocalizationCategory.ToolTip)]
public object ScreenTipHeader { get; set; }

Property Value

object:

The header object that will be displayed in screen tips for the control.

public Uri ScreenTipHelpUri { get; set; }

Property Value

Uri:

The System.Uri specifying the location of context-sensitive help related to the control when its screen tip is displayed and F1 is pressed.

public ImageSource ScreenTipImageSource { get; set; }

Property Value

ImageSource:

The ImageSource for the image that will be displayed in screen tips for the control.

public VariantSize VariantSize { get; set; }

Property Value

VariantSize:

A VariantSize that indicates the control's current variant size. The default value is VariantSize.Medium.

protected virtual object CoerceCommandParameter(DependencyObject obj, object value)

Parameter	Type	Description
obj	DependencyObject	The System.Windows.DependencyObject whose property is changed.
value	object	The new value being set.

Returns

object:

The coerced value to set.

protected virtual void OnClick(ExecuteRoutedEventArgs e)

Parameter	Type	Description
e	ExecuteRoutedEventArgs	An ExecuteRoutedEventArgs that contains the event data.

protected virtual void OnCommandChanged(ICommand oldCommand, ICommand newCommand)

Parameter	Type	Description
oldCommand	ICommand	The old ICommand value.
newCommand	ICommand	The new ICommand value.

protected virtual void OnContextChanged(ControlContext oldContext, ControlContext newContext)

Parameter	Type	Description
oldContext	ControlContext	The old ControlContext value.
newContext	ControlContext	The new ControlContext value.

protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer:

The AutomationPeer that was created.

protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)

Parameter	Type	Description
e	NotifyCollectionChangedEventArgs	A NotifyCollectionChangedEventArgs that contains the event data.

protected virtual bool OnKeyTipAccessed(string keyTipAccessText)

Parameter	Type	Description
keyTipAccessText	string	The key tip access text that was typed.

Returns

bool:

true if an action was executed that should stop key tip mode; otherwise, false.

Remarks

Implementations of this method should either execute the action associated with the control or move focus to the control so that the end user can take further action such as in a menu.

protected override void OnMouseEnter(MouseEventArgs e)

Parameter	Type	Description
e	MouseEventArgs	A MouseEventArgs that contains the event data.

protected override void OnMouseLeave(MouseEventArgs e)

Parameter	Type	Description
e	MouseEventArgs	A MouseEventArgs that contains the event data.

protected virtual void OnPreviewClick(ExecuteRoutedEventArgs e)

Parameter	Type	Description
e	ExecuteRoutedEventArgs	An ExecuteRoutedEventArgs that contains the event data.

protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)

Parameter	Type	Description
e	DependencyPropertyChangedEventArgs	A System.Windows.DependencyPropertyChangedEventArgs that contains the event data.

protected virtual void OnScreenTipClosing(RoutedEventArgs e)

Parameter	Type	Description
e	RoutedEventArgs	A RoutedEventArgs that contains the event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected virtual void OnScreenTipOpening(RoutedEventArgs e)

Parameter	Type	Description
e	RoutedEventArgs	A RoutedEventArgs that contains the event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected override void OnTouchLeave(TouchEventArgs e)

Parameter	Type	Description
e	TouchEventArgs	A TouchEventArgs that contains the event data.

protected virtual void OnValidateItems(IList items)

Parameter	Type	Description
items	IList	The IList of items to validate.

protected virtual void OnVariantSizeChanged(VariantSize oldVariantSize, VariantSize newVariantSize)

Parameter	Type	Description
oldVariantSize	VariantSize	The old VariantSize value.
newVariantSize	VariantSize	The new VariantSize value.

public void RaiseClickEvent(ExecuteRoutedEventArgs e)

Parameter	Type	Description
e	ExecuteRoutedEventArgs	An ExecuteRoutedEventArgs that contains the event data.

protected virtual void SetText(string text)

Parameter	Type	Description
text	string	The text.

protected virtual void UpdateCanExecute()

public event EventHandler<ExecuteRoutedEventArgs> Click

Event Type

EventHandler<ExecuteRoutedEventArgs>

public event EventHandler<ExecuteRoutedEventArgs> PreviewClick

Event Type

EventHandler<ExecuteRoutedEventArgs>

public event RoutedEventHandler ScreenTipClosing

Event Type

RoutedEventHandler

public event RoutedEventHandler ScreenTipOpening

Event Type

RoutedEventHandler

public static readonly RoutedEvent ClickEvent

public static readonly DependencyProperty CommandParameterProperty

public static readonly DependencyProperty CommandProperty

public static readonly DependencyProperty CommandTargetProperty

public static readonly DependencyProperty ContextProperty

public static readonly DependencyProperty HasImageProperty

public static readonly DependencyProperty HasLabelProperty

public static readonly DependencyProperty HintProperty

public static readonly DependencyProperty HintTemplateProperty

public static readonly DependencyProperty HintTemplateSelectorProperty

public static readonly DependencyProperty IdProperty

public static readonly DependencyProperty ImageSourceLargeProperty

public static readonly DependencyProperty ImageSourceSmallProperty

public static readonly DependencyProperty IsHighlightedProperty

public static readonly DependencyProperty IsPointerOverProperty

public static readonly DependencyProperty KeyTipAccessTextProperty

public static readonly DependencyProperty LabelProperty

public static readonly RoutedEvent PreviewClickEvent

public static readonly RoutedEvent ScreenTipClosingEvent

public static readonly DependencyProperty ScreenTipDescriptionProperty

public static readonly DependencyProperty ScreenTipFooterProperty

public static readonly DependencyProperty ScreenTipHeaderProperty

public static readonly DependencyProperty ScreenTipHelpUriProperty

public static readonly DependencyProperty ScreenTipImageSourceProperty

public static readonly RoutedEvent ScreenTipOpeningEvent

public static readonly DependencyProperty VariantSizeProperty