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 |