Método IInvokableCommand.Invoke(Object)

Definição

Espaço de nomes: Microsoft.CommandPalette.Extensions

O método chamado quando um usuário seleciona um comando.

Parâmetros

Objeto do remetente

Representa o contexto de onde o comando foi invocado. Isso pode ser de diferentes tipos, dependendo de onde o comando está sendo usado:

• TopLevelCommands (e fallbacks): sender é o ICommandItem para o comando de nível superior que foi invocado.
• IListPage.GetItems(): sender é o IListItem para o item de lista selecionado para esse comando.
• ICommandItem.MoreCommands (menus de contexto): sender é o IListItem ao qual o comando foi anexado para uma página de listagem ou o ICommandItem do comando de nível superior (se este for um item de contexto em um comando de nível superior).
• IContentPage.Commands: sender é o próprio IContentPage .

Usar o parâmetro sender pode ser útil para grandes listas de itens onde as informações acionáveis para cada item são um pouco as mesmas. Um exemplo seria uma longa lista de links. Você pode implementar isso como um único IInvokableCommand que abre uma URL com base no objeto de remetente passado. Em seguida, cada item da lista armazenaria o URL a ser aberto e o título do link. Isso cria menos sobrecarga para a extensão e o host se comunicarem.

Devoluções

Um ICommandResult objeto que representa o resultado da chamada de comando. Este objeto pode conter informações sobre o sucesso ou falha do comando, bem como quaisquer dados adicionais que possam ser relevantes para a execução do comando.

Exemplo

Consulte Adicionar um comando para obter um exemplo de como implementar esse método.