Метод IAccPropServices::SetPropValue (oleacc.h)
Используйте SetPropValue , чтобы определить доступный элемент для аннотации, указать свойство для аннотации и указать новое значение для этого свойства.
Если разработчики серверов знают HWND элемента со специальными возможностями, которые они хотят добавить, они могут использовать один из следующих методов:
- IAccPropServices::SetHwndPropStr,
- IAccPropServices::SetHwndProp, или
- IAccPropServices::SetHwndPropServer
Синтаксис
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 |