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


Метод IAccPropServices::SetPropValue (oleacc.h)

Используйте SetPropValue , чтобы определить доступный элемент для аннотации, указать свойство для аннотации и указать новое значение для этого свойства.

Если разработчики серверов знают HWND элемента со специальными возможностями, которые они хотят добавить, они могут использовать один из следующих методов:

Синтаксис

HRESULT SetPropValue(
  [in] const BYTE *pIDString,
  [in] DWORD      dwIDStringLen,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

Параметры

[in] pIDString

Тип: const BYTE*

Определяет элемент, к которому осуществляется доступ, для создания заметки.

[in] dwIDStringLen

Тип: DWORD

Указывает длину строки, определенной параметром pIDString.

[in] idProp

Тип: MSAAPROPID

Указывает, для какого свойства элемента, к которому осуществляется доступ, будет создана заметка.

[in] var

Тип: VARIANT

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

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

Тип: HRESULT

Возвращает значение S_OK, если операция завершилась успешно.

Возвращает E_INVALIDARG, если idProp не является поддерживаемым свойством, если var не является поддерживаемым типом для этого свойства или если строка удостоверения недопустима.

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

Комментарии

Список поддерживаемых свойств и их ожидаемых типов см. в разделе поддержки. Обратите внимание, что в настоящее время некоторые свойства поддерживаются только при использовании обратного вызова и не могут быть заданы напрямую с помощью этого метода.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header oleacc.h (сначала включите OleAcc.h Include Initguid.h.)
DLL Oleacc.dll
Распространяемые компоненты Активные специальные возможности 2.0 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 98