Compartilhar via


estrutura UI_EVENTPARAMS_COMMAND (uiribbon.h)

Contém informações sobre um Comando associado a um evento.

Sintaxe

typedef struct _UI_EVENTPARAMS_COMMAND {
  UINT             CommandID;
  PCWSTR           CommandName;
  UINT             ParentCommandID;
  PCWSTR           ParentCommandName;
  UINT             SelectionIndex;
  UI_EVENTLOCATION Location;
} UI_EVENTPARAMS_COMMAND;

Membros

CommandID

A ID do Comando diretamente relacionada ao evento, que é especificado no arquivo de recurso de marcação.

CommandName

O nome do comando associado a CommandId.

ParentCommandID

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

ParentCommandName

O nome de comando do pai associado a CommandId.

SelectionIndex

SelectionIndex é usado somente quando um UI_EVENTTYPE_CommandExecuted é acionado em resposta ao usuário selecionando um item em uma galeria de itens ou ComboBox . Nesses casos, SelectionIndex contém o índice do item selecionado. Em todos os outros casos, ele é definido como 0.

Location

Um dos valores de UI_EVENTLOCATION.

Comentários

O comando identificado por CommandID e CommandName depende de qual evento ocorreu: para um evento UI_EVENTTYPE_TabActivated , eles identificam a guia; para um evento UI_EVENTTYPE_MenuOpened , eles identificam o menu; para eventos UI_EVENTTYPE_CommandExecuted , eles identificam o comando que está sendo executado; e para eventos UI_EVENTTYPE_TooltipShown , eles identificam o Comando que possui essa dica de ferramenta.

ParentCommandID e ParentCommandName identificam o comando pai (se houver) do comando associado a esse evento. Se não houver pai, ParentCommandID será zero e ParentCommandName será uma cadeia de caracteres vazia.

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]
Cabeçalho uiribbon.h

Confira também

OnUIEvent

Estruturas

UI_EVENTPARAMS