CommandBarFlyout Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Представляет специализированный всплывающий элемент, предоставляющий макет для элементов управления AppBarButton, AppBarToggleButton и AppBarSeparator .

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class CommandBarFlyout : FlyoutBase

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class CommandBarFlyout : FlyoutBase

Public Class CommandBarFlyout
Inherits FlyoutBase

<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>

Наследование

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Производный

Microsoft.UI.Xaml.Controls.TextCommandBarFlyout

Атрибуты

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Всплывающий элемент Панели команд.

Откройте приложение коллекции WinUI 3 и просмотрите CommandBarFlyout в действии.

Приложение "Коллекция WinUI 3" содержит интерактивные примеры большинства элементов управления, функций и функций WinUI 3. Получение приложения из Microsoft Store или исходный код на сайте GitHub

Комментарии

Вы можете добавить другие элементы управления в CommandBarFlyout, упаковав их в AppBarElementContainer. Сюда входят такие элементы управления, как DropDownButton или SplitButton, или контейнеры, такие как StackPanel , для более сложного пользовательского интерфейса.

Стиль и шаблон элемента управления

Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в статье Стили XAML. Стиль по умолчанию, шаблон и ресурсы, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях generic.xaml проектирования устанавливается вместе с пакетом NuGet Windows App SDK. По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.

XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML .

Конструкторы

CommandBarFlyout()

Инициализирует новый экземпляр класса CommandBarFlyout .

Свойства

AllowFocusOnInteraction	Возвращает или задает значение, указывающее, получает ли элемент автоматически фокус при взаимодействии с ним. (Унаследовано от FlyoutBase)
AllowFocusWhenDisabled	Возвращает или задает значение, указывающее, может ли элемент управления получать фокус при отключении. (Унаследовано от FlyoutBase)
AlwaysExpanded	Возвращает или задает значение, указывающее, должен ли commandBarFlyout всегда оставаться в развернутом состоянии и блокировать переход пользователя в состояние Свернуто. Значение по умолчанию — false.
AreOpenCloseAnimationsEnabled	Возвращает или задает значение, указывающее, воспроизводится ли анимация при открытии или закрытии всплывающего меню. (Унаследовано от FlyoutBase)
Dispatcher	Всегда возвращается null в приложении Windows App SDK. Вместо этого используйте DispatcherQueue . (Унаследовано от DependencyObject)
DispatcherQueue	Возвращает объект , DispatcherQueue с которым связан данный объект. DispatcherQueue представляет объект, который может получить доступ к потоку DependencyObject пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
ElementSoundMode	Возвращает или задает значение, указывающее предпочтительное значение элемента управления для воспроизведения звуков. (Унаследовано от FlyoutBase)
InputDevicePrefersPrimaryCommands	Возвращает значение, указывающее, не легко ли устройство ввода, используемое для открытия всплывающего меню, открыть дополнительные команды. (Унаследовано от FlyoutBase)
IsConstrainedToRootBounds	Возвращает значение, указывающее, отображается ли всплывающий элемент в пределах корня XAML. Это свойство всегда имеет значение true для Windows App SDK приложений. (Унаследовано от FlyoutBase)
IsOpen	Возвращает значение, указывающее, открыт ли всплывающий элемент. (Унаследовано от FlyoutBase)
LightDismissOverlayMode	Возвращает или задает значение, указывающее, является ли область за пределами закрывающегося пользовательского интерфейса затемнённой. (Унаследовано от FlyoutBase)
OverlayInputPassThroughElement	Возвращает или задает элемент, который должен получать события ввода указателя даже при наложении всплывающего элемента. (Унаследовано от FlyoutBase)
Placement	Возвращает или задает расположение по умолчанию, используемое для всплывающего меню, относительно целевого объекта размещения. (Унаследовано от FlyoutBase)
PrimaryCommands	Возвращает коллекцию основных командных элементов для CommandBarFlyout.
SecondaryCommands	Возвращает коллекцию дополнительных командных элементов для CommandBarFlyout.
ShouldConstrainToRootBounds	Возвращает или задает значение, указывающее, должен ли всплывающий элемент отображаться в границах корня XAML. (Унаследовано от FlyoutBase)
ShowMode	Возвращает или задает значение, указывающее поведение всплывающего меню при отображении. (Унаследовано от FlyoutBase)
SystemBackdrop	Возвращает или задает системный фон для применения к этому всплывающему элементу. Фон отображается за содержимым всплывающего элемента. (Унаследовано от FlyoutBase)
Target	Возвращает элемент, используемый в качестве целевого объекта размещения всплывающего элемента. (Унаследовано от FlyoutBase)
XamlRoot	Возвращает или задает xamlRoot, в котором просматривается этот всплывающий элемент. (Унаследовано от FlyoutBase)

Методы

ClearValue(DependencyProperty)	Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject)
CreatePresenter()	При переопределении в производном классе инициализирует элемент управления для отображения содержимого всплывающего элемента в соответствии с его производным элементом управления. Примечание. Этот метод не имеет реализации базового класса и должен быть переопределен в производном классе. (Унаследовано от FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject)
Hide()	Закрывает всплывающий элемент. (Унаследовано от FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Вызывается непосредственно перед обработкой сочетания клавиш (ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию. (Унаследовано от FlyoutBase)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Регистрирует функцию уведомления для прослушивания изменений определенной DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Показывает всплывающий элемент, размещенный по отношению к указанному элементу с помощью указанных параметров. (Унаследовано от FlyoutBase)
ShowAt(FrameworkElement)	Отображает всплывающий элемент, размещенный по отношению к указанному элементу. (Унаследовано от FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Пытается вызвать сочетание клавиш (ускоритель). (Унаследовано от FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject)

События

Closed	Происходит при скрытии всплывающего меню. (Унаследовано от FlyoutBase)
Closing	Происходит, когда всплывающий элемент начинает скрываться. (Унаследовано от FlyoutBase)
Opened	Происходит при отображении всплывающего меню. (Унаследовано от FlyoutBase)
Opening	Происходит до отображения всплывающего меню. (Унаследовано от FlyoutBase)

См. также раздел

• Всплывающее меню панели команд