Метод IUICommandHandler::Execute (uiribbon.h)

  • Статья

Отвечает на события выполнения в командах, привязанных к обработчику команд.

Синтаксис

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

Параметры

[in] commandId

Тип: UINT32

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

[in] verb

Тип: UI_EXECUTIONVERB

UI_EXECUTIONVERB или действие, инициированное пользователем.

[in, optional] key

Тип: const PROPERTYKEY*

Указатель на ключ свойства , который изменил значение. Этот параметр может принимать значение NULL.

[in, optional] currentValue

Тип: const PROPVARIANT*

Указатель на текущее значение ключа. Этот параметр может принимать значение NULL.

[in, optional] commandExecutionProperties

Тип: IUISimplePropertySet*

Указатель на объект IUISimplePropertySet , содержащий свойства состояния команды и значения свойств, такие как координаты экрана и индексы элементов списка. Этот параметр может принимать значение NULL.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Каждая команда в представлении должна быть привязана к новому или существующему обработчику команд в ведущем приложении.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header uiribbon.h
DLL Mshtml.dll

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

IUICommandHandler

Примеры Windows Ribbon Framework