XamlUICommand Classe

Definição

Namespace:

Windows.UI.Xaml.Input

Fornece uma classe base para definir o comportamento de comando de um elemento de interface do usuário interativo que executa uma ação quando invocada (como enviar um email, excluir um item ou enviar um formulário).

/// [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)]
class XamlUICommand : DependencyObject, ICommand

[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)]
public class XamlUICommand : DependencyObject, ICommand

Public Class XamlUICommand
Inherits DependencyObject
Implements ICommand

Herança

Object IInspectable DependencyObject XamlUICommand

Derivado

Windows.UI.Xaml.Input.StandardUICommand

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

ICommand ICommand

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 Noções básicas de design de comando.

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

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

Comentários

Implementa a interface ICommand (Windows.UI.Xaml.Input.ICommand para C++ ou System.Windows.Input.ICommand para C#), adicionando várias propriedades, métodos e eventos da interface do usuário.

Classes derivadas de XamlUICommand

XamlUICommand é a classe pai para StandardUICommand, que expõe um conjunto de comandos de plataforma padrão com propriedades predefinidas.

Para obter um exemplo de comando básico, consulte o controle Button , que foi projetado para fazer algo acontecer quando um usuário clica nele.

Há duas maneiras de processar um comando Button (controles com uma propriedade Command dão suporte a funcionalidade semelhante):

• Manipular o evento Click.
• Associar a propriedade Command a uma implementação ICommand que descreve a lógica de comando

O XamlUICommand permite especificar a interface do usuário por meio da associação de controle, como ícone, rótulo, descrição e atalhos de teclado (uma tecla de acesso e um acelerador de teclado), sem definir as propriedades individuais.

Construtores

XamlUICommand()

Inicializa uma nova instância da classe XamlUICommand .

Propriedades

AccessKey	Obtém ou define a chave de acesso (mnemônica) para esse elemento.
AccessKeyProperty	Identifica a propriedade de dependência AccessKey .
Command	Obtém ou define o comportamento de comando de um elemento de interface do usuário interativo que executa uma ação quando invocado, como enviar um email, excluir um item ou enviar um formulário.
CommandProperty	Identifica a propriedade de dependência Command .
Description	Obtém ou define uma descrição para esse elemento.
DescriptionProperty	Identifica a propriedade de dependência Description .
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)
IconSource	Obtém ou define um glifo da fonte Segoe MDL2 Assets para esse elemento.
IconSourceProperty	Identifica a propriedade de dependência IconSource .
KeyboardAccelerators	Obtém ou define a coleção de combinações de teclas para esse elemento que invocam uma ação usando o teclado.
KeyboardAcceleratorsProperty	Identifica a propriedade de dependência KeyboardAccelerators .
Label	Obtém ou define o rótulo para esse elemento.
LabelProperty	Identifica a propriedade de dependência Label .

Métodos

CanExecute(Object)	Recupera se o comando pode ser executado em seu estado atual.
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
Execute(Object)	Invoca o comando.
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)
NotifyCanExecuteChanged()	Notifica o sistema de que o estado do comando foi alterado.
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)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Eventos

CanExecuteChanged	Ocorre sempre que algo acontece que afeta se o comando pode ser executado.
CanExecuteRequested	Ocorre quando uma chamada CanExecute é feita.
ExecuteRequested	Ocorre quando uma chamada Executar é feita.

Confira também

• StandardUICommand
• Comando em aplicativos Plataforma Universal do Windows usando StandardUICommand, XamlUICommand e ICommand