Compartilhar via


Método IUICommandHandler::Execute (uiribbon.h)

Responde a eventos de execução em Comandos associados ao manipulador de comando.

Sintaxe

HRESULT Execute(
  [in]           UINT32               commandId,
  [in]           UI_EXECUTIONVERB     verb,
  [in, optional] const PROPERTYKEY    *key,
  [in, optional] const PROPVARIANT    *currentValue,
  [in, optional] IUISimplePropertySet *commandExecutionProperties
);

Parâmetros

[in] commandId

Tipo: UINT32

A ID do Comando, que é especificada no arquivo de recurso de marcação.

[in] verb

Tipo: UI_EXECUTIONVERB

A UI_EXECUTIONVERB ou ação iniciada pelo usuário.

[in, optional] key

Tipo: const PROPERTYKEY*

Um ponteiro para uma chave de propriedade que alterou o valor. Este parâmetro pode ser NULL.

[in, optional] currentValue

Tipo: const PROPVARIANT*

Um ponteiro para o valor atual da chave. Este parâmetro pode ser NULL.

[in, optional] commandExecutionProperties

Tipo: IUISimplePropertySet*

Um ponteiro para um objeto IUISimplePropertySet que contém propriedades de estado command e valores de propriedade, como coordenadas de tela e índices de item de lista. Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Cada Comando em um Modo de Exibição deve ser associado a um manipulador de Comando novo ou existente no aplicativo host.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiribbon.h
DLL Mshtml.dll

Confira também

IUICommandHandler

Exemplos da Estrutura da Faixa de Opções do Windows