CommandBarFlyout Класс

Определение

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

Windows.UI.Xaml.Controls

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

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [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")]
class CommandBarFlyout : FlyoutBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[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")]
public class CommandBarFlyout : FlyoutBase

Public Class CommandBarFlyout
Inherits FlyoutBase

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

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

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Производный

Windows.UI.Xaml.Controls.TextCommandBarFlyout

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Требования к Windows

Семейство устройств	Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v7.0)

Примеры

Совет

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

Если у вас установлено приложение коллекции WinUI 2 , щелкните здесь, чтобы открыть приложение и увидеть CommandBarFlyout в действии.

• Получить приложение из коллекции WinUI 2 в Microsoft Store
• Получить исходный код (GitHub)

Комментарии

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

Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в разделе Стилизация элементов управления. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях разработки generic.xaml доступен локально с установкой пакета SDK или Пакета NuGet.

• * Стили WinUI (рекомендуется): Используйте Microsoft.UI.Xaml.Controls.CommandBarFlyout.
• Стили, отличные от WinUI: Встроенные стили см. в разделе %ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.

Если вы настроили установку, расположения могут отличаться. Стили и ресурсы из разных версий пакета SDK могут иметь разные значения.

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

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

CommandBarFlyout()

Инициализирует новый экземпляр класса CommandBarFlyout . Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Свойства

AllowFocusOnInteraction	Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним. (Унаследовано от FlyoutBase)
AllowFocusWhenDisabled	Возвращает или задает значение, указывающее, может ли элемент управления получать фокус при отключении. (Унаследовано от FlyoutBase)
AreOpenCloseAnimationsEnabled	Возвращает или задает значение, указывающее, воспроизводится ли анимация при открытии или закрытии всплывающего меню. (Унаследовано от FlyoutBase)
Dispatcher	Возвращает объект CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет собой средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
ElementSoundMode	Возвращает или задает значение, указывающее предпочтительное значение элемента управления для воспроизведения звуков. (Унаследовано от FlyoutBase)
InputDevicePrefersPrimaryCommands	Возвращает значение, указывающее, не открывает ли устройство ввода, используемое для открытия всплывающего меню, дополнительные команды. (Унаследовано от FlyoutBase)
IsConstrainedToRootBounds	Возвращает значение, указывающее, отображается ли всплывающее меню в пределах корня XAML. (Унаследовано от FlyoutBase)
IsOpen	Возвращает значение, указывающее, открыт ли всплывающий элемент. (Унаследовано от FlyoutBase)
LightDismissOverlayMode	Возвращает или задает значение, указывающее, затенена ли область за пределами пользовательского интерфейса со светлым закрытием . (Унаследовано от FlyoutBase)
OverlayInputPassThroughElement	Возвращает или задает элемент, который должен получать события ввода указателя, даже если под наложением всплывающего элемента. (Унаследовано от FlyoutBase)
Placement	Возвращает или задает расположение по умолчанию, используемое для всплывающего меню, по отношению к целевому объекту размещения. (Унаследовано от FlyoutBase)
PrimaryCommands	Возвращает коллекцию основных командных элементов для CommandBarFlyout. Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SecondaryCommands	Возвращает коллекцию дополнительных командных элементов для CommandBarFlyout. Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
ShouldConstrainToRootBounds	Возвращает или задает значение, указывающее, должен ли всплывающий элемент отображаться в границах корня XAML. (Унаследовано от FlyoutBase)
ShowMode	Возвращает или задает значение, указывающее поведение всплывающего меню при отображении. (Унаследовано от 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)