Метод IUIFramework::SetUICommandProperty (uiribbon.h)

  • Статья

Задает свойство, значение или состояние команды.

Синтаксис

HRESULT SetUICommandProperty(
  [in] UINT32         commandId,
  [in] REFPROPERTYKEY key,
  [in] REFPROPVARIANT value
);

Параметры

[in] commandId

Тип: UINT32

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

[in] key

Тип: REFPROPERTYKEY

Ключ свойства команды, значения или состояния.

[in] value

Тип: PROPVARIANT

Свойство, значение или состояние.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения, в противном случае — значение ошибки из следующего списка.

Значение Описание
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) Свойство, значение или состояние не поддерживают IUIFramework::SetUICommandProperty. Они могут поддерживать настройку только через недействительность.
E_FAIL Операция не удалась.

Комментарии

С помощью IUIFramework::SetUICommandProperty можно задать ограниченное количество ключей свойств. Для тех свойств, в которых IUIFramework::SetUICommandProperty возвращает HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED),следует использовать IUIFramework::InvalidateUICommand .

Дополнительные сведения о том, как задать ключ свойств для определенного элемента управления, см. на странице Библиотека элементов управления Windows Ribbon Framework для этого элемента управления.

Требования

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

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

IUIFramework

Примеры Windows Ribbon Framework