CommandBarFlyout Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : FlyoutBasePublic Class CommandBarFlyout
Inherits FlyoutBase<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
commandBarElements
</CommandBarFlyout>
- Herança
- Derivado
- Atributos
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.
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) |
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de