XamlUICommand Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce una classe di base per definire il comportamento del comando di un elemento interattivo dell'interfaccia utente che esegue un'azione quando viene richiamata , ad esempio l'invio di un messaggio di posta elettronica, l'eliminazione di un elemento o l'invio di un modulo.
/// [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- Ereditarietà
- Derivato
- Attributi
- Implementazioni
Esempio
Tip
Per altre info, linee guida per la progettazione ed esempi di codice, vedi Nozioni di base sul comando.
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Ottenere l'app dal Microsoft Store o ottenere il codice sorgente in GitHub.
Commenti
Implementa l'interfaccia ICommand (Microsoft. UI. Xaml.Input.ICommand per C++ o System.Windows. Input.ICommand per C#), aggiungendo varie proprietà, metodi ed eventi dell'interfaccia utente.
Classi derivate XamlUICommand
XamlUICommand è la classe padre per StandardUICommand, che espone un set di comandi della piattaforma standard con proprietà predefinite.
Per un esempio di comando di base, vedere il controllo Button , progettato per fare qualcosa quando un utente lo fa clic.
Esistono due modi per elaborare un Button comando (i controlli con una Command proprietà supportano funzionalità simili):
- Gestire l'evento
Click - Associare la
Commandproprietà a un'implementazioneICommandche descrive la logica del comando
XamlUICommand consente di specificare l'interfaccia utente tramite l'associazione di controllo, ad esempio un'icona, un'etichetta, una descrizione e i tasti di scelta rapida (sia un tasto di scelta che un tasto di scelta rapida), senza impostare le singole proprietà.
Costruttori
| Nome | Descrizione |
|---|---|
| XamlUICommand() |
Inizializza una nuova istanza della classe XamlUICommand . |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessKey |
Ottiene o imposta il tasto di scelta (mnemonico) per questo elemento. |
| AccessKeyProperty |
Identifica la proprietà di dipendenza AccessKey . |
| Command |
Ottiene o imposta il comportamento del comando di un elemento interattivo dell'interfaccia utente che esegue un'azione quando viene richiamata, ad esempio l'invio di un messaggio di posta elettronica, l'eliminazione di un elemento o l'invio di un modulo. |
| CommandProperty |
Identifica la proprietà di dipendenza Command . |
| Description |
Ottiene o imposta una descrizione per questo elemento. |
| DescriptionProperty |
Identifica la proprietà di dipendenza Description . |
| Dispatcher |
Restituisce |
| DispatcherQueue |
Ottiene l'oggetto |
| IconSource |
Ottiene o imposta un glifo dal tipo di carattere Segoe MDL2 Assets per questo elemento. |
| IconSourceProperty |
Identifica la proprietà di dipendenza IconSource . |
| KeyboardAccelerators |
Ottiene la raccolta di combinazioni di tasti per questo elemento che richiamano un'azione utilizzando la tastiera. |
| KeyboardAcceleratorsProperty |
Identifica la proprietà di dipendenza KeyboardAccelerators . |
| Label |
Ottiene o imposta l'etichetta per questo elemento. |
| LabelProperty |
Identifica la proprietà di dipendenza Label . |
Metodi
| Nome | Descrizione |
|---|---|
| CanExecute(Object) |
Recupera un valore che indica se il comando può essere eseguito nello stato corrente. |
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject) |
| Execute(Object) |
Richiama il comando . |
| GetAnimationBaseValue(DependencyProperty) |
Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject) |
| NotifyCanExecuteChanged() |
Notifica al sistema che lo stato del comando è stato modificato. |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una funzione di notifica per l'ascolto delle modifiche a una dipendenza specifica in questa istanza dependencyObject . (Ereditato da DependencyObject) |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza in un Oggetto DependencyObject. (Ereditato da DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject) |
Eventi
| Nome | Descrizione |
|---|---|
| CanExecuteChanged |
Si verifica ogni volta che si verifica un evento che influisce sul fatto che il comando possa essere eseguito. |
| CanExecuteRequested |
Si verifica quando viene eseguita una chiamata CanExecute . |
| ExecuteRequested |
Si verifica quando viene eseguita una chiamata Execute . |