Поделиться через


структура UI_EVENTPARAMS_COMMAND (uiribbon.h)

Содержит сведения о команде , связанной с событием.

Синтаксис

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

Члены

CommandID

Идентификатор команды , непосредственно связанный с событием , который указан в файле ресурсов разметки.

CommandName

Имя команды , связанное с CommandId.

ParentCommandID

Идентификатор родительского элемента Command, указанного в файле ресурсов разметки.

ParentCommandName

Имя команды родительского объекта, связанного с CommandId.

SelectionIndex

SelectionIndex используется только при срабатывании UI_EVENTTYPE_CommandExecuted в ответ на выбор пользователем элемента в comboBox или коллекции элементов. В таких случаях SelectionIndex содержит индекс выбранного элемента. Во всех остальных случаях ему присваивается значение 0.

Location

Одно из значений из UI_EVENTLOCATION.

Комментарии

Команда, определяемая commandID и CommandName , зависит от того, какое событие произошло: для события UI_EVENTTYPE_TabActivated они определяют вкладку; для события UI_EVENTTYPE_MenuOpened они определяют меню; для событий UI_EVENTTYPE_CommandExecuted они определяют выполняемую команду; а для событий UI_EVENTTYPE_TooltipShown они определяют команду , которой принадлежит эта подсказка.

ParentCommandID и ParentCommandName идентифицируют родительскую команду (при наличии) команды, связанной с этим событием. Если родительский элемент отсутствует, параметр ParentCommandID равен нулю, а ParentCommandName является пустой строкой.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть uiribbon.h

См. также раздел

OnUIEvent

Структуры

UI_EVENTPARAMS