CommandBarFlyout Classe

Definição

Namespace:

Windows.UI.Xaml.Controls

Representa um submenu especializado que fornece layout para AppBarButton e elementos de comando relacionados.

API equivalente do WinUI 2 para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

/// [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>

Herança

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Derivado

Windows.UI.Xaml.Controls.TextCommandBarFlyout

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Submenu da barra de comandos.

Se você tiver o aplicativo WinUI 2 Gallery instalado, clique aqui para abrir o aplicativo e ver o CommandBarFlyout em ação.

• Obtenha o aplicativo WinUI 2 Gallery (Microsoft Store)
• Obtenha o código-fonte (GitHub)

Comentários

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Controles de estilo. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml está disponível localmente com a instalação do pacote SDK ou NuGet.

• * Estilos de WinUI (recomendado): Use Microsoft.UI.Xaml.Controls.CommandBarFlyout.
• Estilos não WinUI: Para estilos internos, consulte %ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.

Os locais podem ser diferentes se você personalizou a instalação. Estilos e recursos de diferentes versões do SDK podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML . Recursos de estilo leve estão disponíveis a partir de Windows 10, versão 1607 (SDK 14393).

Construtores

CommandBarFlyout()

Inicializa uma nova instância da classe CommandBarFlyout . API equivalente do WinUI 2 para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

AllowFocusOnInteraction	Obtém ou define um valor que indica se o elemento obtém automaticamente o foco quando o usuário interage com ele. (Herdado de FlyoutBase)
AllowFocusWhenDisabled	Obtém ou define um valor que especifica se o controle pode receber foco quando está desabilitado. (Herdado de FlyoutBase)
AreOpenCloseAnimationsEnabled	Obtém ou define um valor que indica se as animações são reproduzidas quando o submenu é aberto ou fechado. (Herdado de FlyoutBase)
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
ElementSoundMode	Obtém ou define um valor que especifica a preferência do controle para se ele reproduz sons. (Herdado de FlyoutBase)
InputDevicePrefersPrimaryCommands	Obtém um valor que indica se o dispositivo de entrada usado para abrir o submenu não abre facilmente os comandos secundários. (Herdado de FlyoutBase)
IsConstrainedToRootBounds	Obtém um valor que indica se o submenu é mostrado dentro dos limites da raiz XAML. (Herdado de FlyoutBase)
IsOpen	Obtém um valor que indica se o submenu está aberto. (Herdado de FlyoutBase)
LightDismissOverlayMode	Obtém ou define um valor que especifica se a área fora de uma interface do usuário de descarte claro está escurecida. (Herdado de FlyoutBase)
OverlayInputPassThroughElement	Obtém ou define um elemento que deve receber eventos de entrada de ponteiro mesmo quando estiver abaixo da sobreposição do submenu. (Herdado de FlyoutBase)
Placement	Obtém ou define o posicionamento padrão a ser usado para o submenu, em relação ao seu destino de posicionamento. (Herdado de FlyoutBase)
PrimaryCommands	Obtém a coleção de elementos de comando primários para o CommandBarFlyout. API equivalente do WinUI 2 para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SecondaryCommands	Obtém a coleção de elementos de comando secundários para CommandBarFlyout. API equivalente do WinUI 2 para UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShouldConstrainToRootBounds	Obtém ou define um valor que indica se o submenu deve ser mostrado dentro dos limites da raiz XAML. (Herdado de FlyoutBase)
ShowMode	Obtém ou define um valor que indica como um submenu se comporta quando mostrado. (Herdado de FlyoutBase)
Target	Obtém o elemento a ser usado como o destino de posicionamento do submenu. (Herdado de FlyoutBase)
XamlRoot	Obtém ou define o XamlRoot no qual esse submenu está sendo exibido. (Herdado de FlyoutBase)

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
CreatePresenter()	Quando substituído em uma classe derivada, inicializa um controle para mostrar o conteúdo do submenu conforme apropriado para o controle derivado. Observação: esse método não tem implementação de classe base e deve ser substituído em uma classe derivada. (Herdado de FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
Hide()	Fecha o submenu. (Herdado de FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Chamado pouco antes de um atalho de teclado (acelerador) ser processado em seu aplicativo. Invocado sempre que o código do aplicativo ou processos internos chamam ProcessKeyboardAccelerators. Substitua esse método para influenciar a manipulação do acelerador padrão. (Herdado de FlyoutBase)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Mostra o submenu colocado em relação ao elemento especificado usando as opções especificadas. (Herdado de FlyoutBase)
ShowAt(FrameworkElement)	Mostra o submenu colocado em relação ao elemento especificado. (Herdado de FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tenta invocar um atalho de teclado (acelerador). (Herdado de FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Eventos

Closed	Ocorre quando o submenu está oculto. (Herdado de FlyoutBase)
Closing	Ocorre quando o submenu começa a ficar oculto. (Herdado de FlyoutBase)
Opened	Ocorre quando o submenu é mostrado. (Herdado de FlyoutBase)
Opening	Ocorre antes que o submenu seja mostrado. (Herdado de FlyoutBase)