Compartir a través de

Método IAccPropServer::GetPropValue (oleacc.h)

  • Artículo

Recupera un valor de propiedad para un elemento accesible.

Sintaxis

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

Parámetros

[in] pIDString

Tipo: const BYTE*

Contiene una cadena que identifica la propiedad que se solicita.

[in] dwIDStringLen

Tipo: DWORD

Especifica la longitud de la cadena de identidad especificada por el parámetro pIDString.

[in] idProp

Tipo: MSAAPROPID

Especifica un GUID que indica la propiedad deseada.

[out] pvarValue

Tipo: VARIANT*

Especifica el valor de la propiedad reemplazada. Este parámetro solo es válido si pfHasProp es TRUE. El servidor debe establecerlo en VT_EMPTY si pfHasProp está establecido en FALSE.

[out] pfHasProp

Tipo: BOOL*

Indica si el servidor proporciona un valor para la propiedad solicitada. El servidor debe establecerlo en TRUE si devuelve una propiedad invalidada o en FALSE si no devuelve una propiedad (en cuyo caso también debe establecer pvarValue en VT_EMPTY).

Valor devuelto

Tipo: HRESULT

Devuelve S_OK, excepto en condiciones de error excepcionales, como poca memoria. Si la propiedad especificada no se invalida, pfHasProp debe establecerse en FALSE y pvarValue debe establecerse en VT_EMPTY por el servidor.

Comentarios

Si se registra un único objeto de devolución de llamada para anotar varios elementos accesibles, la cadena de identidad se puede usar para determinar a qué elemento hace referencia esta solicitud.

Si el elemento accesible está basado en HWND, IAccPropServices::D ecomposeHwndIdentityString se puede usar para extraer el HWND/idObject/idChild de la cadena de identidad.

Si la devolución de llamada tiene un valor que se va a devolver para la propiedad especificada, debe devolverla en pvarValue y establecer pfHasProp en TRUE. De lo contrario, debe establecer pvarValue en VT_EMPTY y establecer pfHasProp en FALSE. En este último caso, el puntero de interfaz IAccessible original se usará para obtener un valor para esta propiedad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista o Windows XP
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado oleacc.h (incluya OleAcc.h Include Initguid.h first).)
Archivo DLL Oleacc.dll
Redistribuible RDK de accesibilidad activa 2.0 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 98