XamlUICommand Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una clase base para definir el comportamiento de comando de un elemento interactivo de la interfaz de usuario que realiza una acción cuando se invoca (por ejemplo, enviar un correo electrónico, eliminar un elemento o enviar un formulario).
/// [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, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- Herencia
- Derivado
- Atributos
- Implementaciones
Ejemplos
Sugerencia
Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Conceptos básicos de comandos.
La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, las características y la funcionalidad de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.
Comentarios
Implementa la ICommand interfaz (Microsoft.UI.Xaml.Input.ICommand para C++ o System.Windows.Input.ICommand para C#), agregando varias propiedades, métodos y eventos de interfaz de usuario.
Clases derivadas xamlUICommand
XamlUICommand es la clase primaria de StandardUICommand, que expone un conjunto de comandos de plataforma estándar con propiedades predefinidas.
Para obtener un ejemplo básico de comandos, vea el control Botón , que está diseñado para hacer que algo suceda cuando un usuario hace clic en él.
Hay dos maneras de procesar un Button comando (los controles con una Command propiedad admiten una funcionalidad similar):
- Controlar el
Clickevento - Enlazar la
Commandpropiedad a unaICommandimplementación que describe la lógica del comando
XamlUICommand permite especificar la interfaz de usuario mediante el enlace de control, como un icono, una etiqueta, una descripción y métodos abreviados de teclado (tanto una tecla de acceso como un acelerador de teclado), sin establecer las propiedades individuales.
Constructores
| XamlUICommand() |
Inicializa una nueva instancia de la clase XamlUICommand . |
Propiedades
| AccessKey |
Obtiene o establece la clave de acceso (mnemonic) para este elemento. |
| AccessKeyProperty |
Identifica la propiedad de dependencia AccessKey . |
| Command |
Obtiene o establece el comportamiento de comando de un elemento interactivo de la interfaz de usuario que realiza una acción cuando se invoca, como enviar un correo electrónico, eliminar un elemento o enviar un formulario. |
| CommandProperty |
Identifica la propiedad de dependencia Command . |
| Description |
Obtiene o establece una descripción de este elemento. |
| DescriptionProperty |
Identifica la propiedad de dependencia Description . |
| Dispatcher |
Siempre devuelve |
| DispatcherQueue |
Obtiene el objeto |
| IconSource |
Obtiene o establece un glifo de la fuente Segoe MDL2 Assets para este elemento. |
| IconSourceProperty |
Identifica la propiedad de dependencia IconSource . |
| KeyboardAccelerators |
Obtiene la colección de combinaciones de teclas para este elemento que invocan una acción mediante el teclado. |
| KeyboardAcceleratorsProperty |
Identifica la propiedad de dependencia KeyboardAccelerators . |
| Label |
Obtiene o establece la etiqueta de este elemento. |
| LabelProperty |
Identifica la propiedad de dependencia Label . |
Métodos
| CanExecute(Object) |
Recupera si el comando se puede ejecutar en su estado actual. |
| ClearValue(DependencyProperty) |
Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject) |
| Execute(Object) |
Invoca el comando. |
| GetAnimationBaseValue(DependencyProperty) |
Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject) |
| GetValue(DependencyProperty) |
Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject) |
| NotifyCanExecuteChanged() |
Notifica al sistema que el estado del comando ha cambiado. |
| ReadLocalValue(DependencyProperty) |
Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela una notificación de cambio registrada anteriormente mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |
Eventos
| CanExecuteChanged |
Se produce cada vez que sucede algo que afecta a si el comando puede ejecutarse. |
| CanExecuteRequested |
Se produce cuando se realiza una llamada a CanExecute . |
| ExecuteRequested |
Se produce cuando se realiza una llamada Execute . |