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(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[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
- Derivado
- Atributos
- Implementações
Exemplos
Tip
Para obter mais informações, diretrizes de design e exemplos de código, consulte noções básicas de comando.
O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou obtenha o código-fonte no GitHub.
Comentários
Implementa a ICommand interface (Microsoft. UI. Xaml.Input.ICommand para C++ ou System.Windows. Input.ICommand para C#), adicionando várias propriedades de interface do usuário, métodos e eventos.
Classes derivadas de XamlUICommand
XamlUICommand é a classe pai de 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 Button comando (controles com uma Command propriedade dão suporte a funcionalidades semelhantes):
- Manipular o
Clickevento - Associar a
Commandpropriedade a uma implementaçãoICommandque descreve a lógica de comando
XamlUICommand permite especificar a interface do usuário por meio da associação de controle, como um ícone, rótulo, descrição e atalhos de teclado (uma tecla de acesso e um acelerador de teclado), sem definir as propriedades individuais.
Construtores
| Nome | Description |
|---|---|
| XamlUICommand() |
Inicializa uma nova instância da classe XamlUICommand . |
Propriedades
| Nome | Description |
|---|---|
| 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 Descrição . |
| Dispatcher |
Sempre retorna |
| DispatcherQueue |
Obtém o |
| 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 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 desse elemento. |
| LabelProperty |
Identifica a propriedade de dependência Label . |
Métodos
| Nome | Description |
|---|---|
| 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 em 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 um DependencyProperty específico 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
| Nome | Description |
|---|---|
| CanExecuteChanged |
Ocorre sempre que ocorre algo que afeta se o comando pode ser executado. |
| CanExecuteRequested |
Ocorre quando uma chamada CanExecute é feita. |
| ExecuteRequested |
Ocorre quando uma chamada Executar é feita. |