Partilhar via

ICommand Interface

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Input
Editar

Define o comportamento de comando de um elemento interativo da interface do usuário que executa uma ação quando invocado, como enviar um email, excluir um item ou enviar um formulário.

public interface class ICommand
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3853464898, 51815, 16513, 153, 91, 112, 157, 209, 55, 146, 223)]
struct ICommand
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(3853464898, 51815, 16513, 153, 91, 112, 157, 209, 55, 146, 223)]
public interface ICommand
Public Interface ICommand
Derivado
Atributos
ContractVersionAttribute GuidAttribute

Exemplos

Aqui, definimos um comando que simplesmente retransmite sua funcionalidade para outros objetos.

Consulte o exemplo de noções básicas de interface do usuário (XAML) para obter o aplicativo completo.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Input;
namespace AppUIBasics.Common
{
    /// <summary>
    /// A command whose sole purpose is to relay its functionality
    /// to other objects by invoking delegates.
    /// The default return value for the CanExecute method is 'true'.
    /// RaiseCanExecuteChanged needs to be called whenever
    /// CanExecute is expected to return a different value.
    /// </summary>
    public class RelayCommand : ICommand
    {
        private readonly Action _execute;
        private readonly Func<bool> _canExecute;
        /// <summary>
        /// Raised when RaiseCanExecuteChanged is called.
        /// </summary>
        public event EventHandler CanExecuteChanged;
        /// <summary>
        /// Creates a new command that can always execute.
        /// </summary>
        /// <param name="execute">The execution logic.</param>
        public RelayCommand(Action execute)
            : this(execute, null)
        {
        }
        /// <summary>
        /// Creates a new command.
        /// </summary>
        /// <param name="execute">The execution logic.</param>
        /// <param name="canExecute">The execution status logic.</param>
        public RelayCommand(Action execute, Func<bool> canExecute)
        {
            if (execute == null)
                throw new ArgumentNullException("execute");
            _execute = execute;
            _canExecute = canExecute;
        }
        /// <summary>
        /// Determines whether this RelayCommand can execute in its current state.
        /// </summary>
        /// <param name="parameter">
        /// Data used by the command. If the command does not require data to be passed,
        /// this object can be set to null.
        /// </param>
        /// <returns>true if this command can be executed; otherwise, false.</returns>
        public bool CanExecute(object parameter)
        {
            return _canExecute == null ? true : _canExecute();
        }
        /// <summary>
        /// Executes the RelayCommand on the current command target.
        /// </summary>
        /// <param name="parameter">
        /// Data used by the command. If the command does not require data to be passed,
        /// this object can be set to null.
        /// </param>
        public void Execute(object parameter)
        {
            _execute();
        }
        /// <summary>
        /// Method used to raise the CanExecuteChanged event
        /// to indicate that the return value of the CanExecute
        /// method has changed.
        /// </summary>
        public void RaiseCanExecuteChanged()
        {
            var handler = CanExecuteChanged;
            if (handler != null)
            {
                handler(this, EventArgs.Empty);
            }
        }
    }
}

Comentários

XamlUICommand implementa essa ICommand interface para C++ ou System.Windows.Input.ICommand para C# (adicionando várias propriedades, métodos e eventos da interface do usuário).

Para obter um exemplo básico, consulte o controle Button , que invoca um comando quando um usuário clica nele. Há duas maneiras de gerenciar a experiência de comando:

  • Manipular o Click evento
  • Associar a Command propriedade a uma implementação ICommand que descreve a lógica de comando

Métodos

CanExecute(Object)

Recupera se o comando pode ser executado em seu estado atual.
Execute(Object)

Define o método a ser chamado quando o comando for invocado.

Eventos

CanExecuteChanged

Ocorre sempre que algo acontece que afeta se o comando pode ser executado.

Aplica-se a

Confira também