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

Метод IAccPropServer::GetPropValue (oleacc.h)

  • Статья

Извлекает значение свойства для элемента со специальными возможностями.

Синтаксис

HRESULT GetPropValue(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [in]  MSAAPROPID idProp,
  [out] VARIANT    *pvarValue,
  [out] BOOL       *pfHasProp
);

Параметры

[in] pIDString

Тип: const BYTE*

Содержит строку, определяющую запрашиваемое свойство.

[in] dwIDStringLen

Тип: DWORD

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

[in] idProp

Тип: MSAAPROPID

Указывает идентификатор GUID, указывающий требуемое свойство.

[out] pvarValue

Тип: VARIANT*

Указывает значение переопределенного свойства. Этот параметр действителен, только если pfHasProp имеет значение TRUE. Сервер должен задать для этого параметра значение VT_EMPTY, если pfHasProp имеет значение FALSE.

[out] pfHasProp

Тип: BOOL*

Указывает, предоставляет ли сервер значение для запрашиваемого свойства. Сервер должен присвоить этому параметру значение TRUE , если он возвращает переопределяющее свойство, или значение FALSE , если свойство не возвращается (в этом случае также следует задать для параметра pvarValue значение VT_EMPTY).

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

Тип: HRESULT

Возвращать S_OK, за исключением исключительных условий ошибок, таких как нехватка памяти. Если указанное свойство не переопределено, то для параметра pfHasProp должно быть задано значение FALSE , а для параметра pvarValue — значение VT_EMPTY сервером.

Комментарии

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

Если доступный элемент основан на HWND, можно использовать IAccPropServices::D ecomposeHwndIdentityString для извлечения HWND/idObject/idChild из строки удостоверения.

Если обратный вызов имеет значение, возвращаемое для указанного свойства, он должен вернуть его в pvarValue и присвоить pfHasProp значение TRUE. В противном случае следует задать для параметра pvarValue значение VT_EMPTY, а для параметра pfHasProp — значение FALSE. В последнем случае для получения значения этого свойства будет использоваться исходный указатель интерфейса IAccessible .

Требования

Требование Значение
Минимальная версия клиента Windows Vista или 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