In This Article

BarMenuGalleryHostBase Class

Represents an abstract base class for a gallery control that can host a related BarMenuGallery in its popup.

public abstract class BarMenuGalleryHostBase : BarGalleryBase
Inheritance:
object Visual UIElement FrameworkElement Control ItemsControl Selector BarGalleryBase object
Derived:
BarComboBox RibbonGallery

Constructors

BarMenuGalleryHostBase()

Initializes an instance of the class.

protected BarMenuGalleryHostBase()

Properties

AboveMenuItems

The collection of menu items that appear above the implicitly-created menu gallery in this gallery's popup.

public IList? AboveMenuItems { get; set; }

Property Value

IList

Remarks

This property is only used when the control is not created via MVVM.

See Also

AreSurroundingSeparatorsAllowedOnMenu

Indicates whether the implicitly-created menu gallery in this gallery's popup can render surrounding separators.

public bool AreSurroundingSeparatorsAllowedOnMenu { get; set; }

Property Value

bool:

true if the implicitly-created menu gallery in this gallery's popup can render surrounding separators; otherwise, false. The default value is true.

Remarks

This property is only used when the control is not created via MVVM.

BelowMenuItems

The collection of menu items that appear below the implicitly-created menu gallery in this gallery's popup.

public IList? BelowMenuItems { get; set; }

Property Value

IList

Remarks

This property is only used when the control is not created via MVVM.

See Also

CanCategorizeOnMenu

Indicates whether the implicitly-created menu gallery in this gallery's popup sorts and displays items by category when an System.ComponentModel.ICollectionView is set to the ItemsSource.

public bool CanCategorizeOnMenu { get; set; }

Property Value

bool:

true if the implicitly-created menu gallery in this gallery's popup sorts and displays items by category when an System.ComponentModel.ICollectionView is set to the ItemsSource; otherwise, false. The default value is true.

Remarks

This property is only used when the control is not created via MVVM.

CanFilterOnMenu

Indicates whether the implicitly-created menu gallery in this gallery's popup supports filtering of items by category.

public bool CanFilterOnMenu { get; set; }

Property Value

bool:

true if the implicitly-created menu gallery in this gallery's popup supports filtering of items by category; otherwise, false. The default value is false.

Remarks

This property is only used when the control is not created via MVVM.

CategoryHeaderTemplate

The DataTemplate to display the category header on the implicitly-created menu gallery in this gallery's popup.

public DataTemplate? CategoryHeaderTemplate { get; set; }

Property Value

DataTemplate

Remarks

This property is only used when the control is not created via MVVM.

HasCategoryHeadersOnMenu

Indicates whether the implicitly-created menu gallery in this gallery's popup has category headers when categorizing.

public bool HasCategoryHeadersOnMenu { get; set; }

Property Value

bool:

true if the implicitly-created menu gallery in this gallery's popup has category headers when categorizing; otherwise, false. The default value is true.

Remarks

This property is only used when the control is not created via MVVM.

InvocationFocusBehavior

Indicates how the control processes focus when a commit occurs.

public InvocationFocusBehavior InvocationFocusBehavior { get; set; }

Property Value

InvocationFocusBehavior:

The default value is Default.

MaxMenuColumnCount

The maximum number of columns in the implicitly-created menu gallery in this gallery's popup.

public int MaxMenuColumnCount { get; set; }

Property Value

int:

The default value is MaxValue.

Remarks

This property is only used when the control is not created via MVVM.

MaxMenuGalleryHeight

The maximum height of the implicitly-created menu gallery in this gallery's popup.

public int MaxMenuGalleryHeight { get; set; }

Property Value

int:

The default value is 1000.0>.

Remarks

This property is only used when the control is not created via MVVM.

MenuResizeMode

A ControlResizeMode that indicates how the popup menu can resize.

public ControlResizeMode MenuResizeMode { get; set; }

Property Value

ControlResizeMode:

The default value is None.

Remarks

This property is only used when the control is not created via MVVM.

MinMenuColumnCount

The minimum number of columns in the implicitly-created menu gallery in this gallery's popup.

public int MinMenuColumnCount { get; set; }

Property Value

int:

The default value is 1.

Remarks

This property is only used when the control is not created via MVVM.

PopupClosedCommand

The ICommand that executes after the gallery's popup is closed, allowing its items to be customized in MVVM scenarios.

public ICommand? PopupClosedCommand { get; set; }

Property Value

ICommand

PopupOpeningCommand

The ICommand that executes before the gallery's popup is opened, allowing its items to be customized in MVVM scenarios.

public ICommand? PopupOpeningCommand { get; set; }

Property Value

ICommand

SelectedFilterCategory

The selected filter category name.

[Localizability(LocalizationCategory.Title)]
public string? SelectedFilterCategory { get; set; }

Property Value

string

UseMenuItemAppearance

Indicates whether to use a menu item appearance for gallery items, common for single-column menu galleries.

public bool UseMenuItemAppearance { get; set; }

Property Value

bool:

true if gallery items should use a menu item appearance; otherwise, false. The default value is false.

Remarks

This property is only used when the control is not created via MVVM.

UseMenuItemIndent

Indicates whether to align gallery items in the implicitly-created menu gallery in this gallery's popup so that they indent past the menu's icon column.

public bool UseMenuItemIndent { get; set; }

Property Value

bool:

true if gallery items should be indented past the menu's icon column; otherwise, false. The default value is false.

Remarks

This property is only used when the control is not created via MVVM.

Fields

AboveMenuItemsProperty

Defines the AboveMenuItems property.

public static readonly DependencyProperty AboveMenuItemsProperty

AreSurroundingSeparatorsAllowedOnMenuProperty

public static readonly DependencyProperty AreSurroundingSeparatorsAllowedOnMenuProperty

BelowMenuItemsProperty

Defines the BelowMenuItems property.

public static readonly DependencyProperty BelowMenuItemsProperty

CanCategorizeOnMenuProperty

Defines the CanCategorizeOnMenu property.

public static readonly DependencyProperty CanCategorizeOnMenuProperty

CanFilterOnMenuProperty

Defines the CanFilterOnMenu property.

public static readonly DependencyProperty CanFilterOnMenuProperty

CategoryHeaderTemplateProperty

Defines the CategoryHeaderTemplate property.

public static readonly DependencyProperty CategoryHeaderTemplateProperty

HasCategoryHeadersOnMenuProperty

Defines the HasCategoryHeadersOnMenu property.

public static readonly DependencyProperty HasCategoryHeadersOnMenuProperty

InvocationFocusBehaviorProperty

Defines the InvocationFocusBehavior property.

public static readonly DependencyProperty InvocationFocusBehaviorProperty

MaxMenuColumnCountProperty

Defines the MaxMenuColumnCount property.

public static readonly DependencyProperty MaxMenuColumnCountProperty

MaxMenuGalleryHeightProperty

Defines the MaxMenuGalleryHeight property.

public static readonly DependencyProperty MaxMenuGalleryHeightProperty

MenuResizeModeProperty

Defines the MenuResizeMode property.

public static readonly DependencyProperty MenuResizeModeProperty

MinMenuColumnCountProperty

Defines the MinMenuColumnCount property.

public static readonly DependencyProperty MinMenuColumnCountProperty

PopupClosedCommandProperty

Defines the PopupClosedCommand property.

public static readonly DependencyProperty PopupClosedCommandProperty

PopupOpeningCommandProperty

Defines the PopupOpeningCommand property.

public static readonly DependencyProperty PopupOpeningCommandProperty

SelectedFilterCategoryProperty

Defines the SelectedFilterCategory property.

public static readonly DependencyProperty SelectedFilterCategoryProperty

UseMenuItemAppearanceProperty

Defines the UseMenuItemAppearance property.

public static readonly DependencyProperty UseMenuItemAppearanceProperty

UseMenuItemIndentProperty

Defines the UseMenuItemIndent property.

public static readonly DependencyProperty UseMenuItemIndentProperty

Inherited Members

Extension Methods