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
Dica
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 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, 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 Button
comando (controles com uma Command
propriedade dão suporte a funcionalidades semelhantes):
- Manipular o
Click
evento - Associar a
Command
propriedade a uma implementaçãoICommand
que 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
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 |
Sempre retorna |
DispatcherQueue |
Obtém o ao |
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 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. |