XamlUICommand 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.
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, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- Herança
- Derivado
- Atributos
- Implementações
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.
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. |