Metodo IAccPropServer::GetPropValue (oleacc.h)

Recupera un valore della proprietà per un elemento accessibile.

Sintassi

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

Parametri

[in] pIDString

Tipo: const BYTE*

Contiene una stringa che identifica la proprietà richiesta.

[in] dwIDStringLen

Tipo: DWORD

Indica la lunghezza della stringa di identità specificata dal parametro pIDString.

[in] idProp

Tipo: MSAAPROPID

Specifica un GUID indicante la proprietà desiderata.

[out] pvarValue

Tipo: VARIANT*

Specifica il valore della proprietà sottoposta a override. Questo parametro è valido solo se pfHasProp è TRUE. Il server deve impostarlo su VT_EMPTY se pfHasProp è impostato su FALSE.

[out] pfHasProp

Tipo: BOOL*

Indica se il server fornisce un valore per la proprietà richiesta. Il server deve impostare questa proprietà su TRUE se restituisce una proprietà di override o su FALSE se non restituisce una proprietà ( nel qual caso deve anche impostare pvarValue su VT_EMPTY).

Valore restituito

Tipo: HRESULT

Restituisce S_OK, ad eccezione di condizioni di errore eccezionali, ad esempio memoria insufficiente. Se la proprietà specificata non viene sottoposta a override, pfHasProp deve essere impostata su FALSE e pvarValue deve essere impostata su VT_EMPTY dal server.

Commenti

Se un singolo oggetto callback viene registrato per annotare più elementi accessibili, è possibile utilizzare la stringa di identità per determinare l'elemento a cui fa riferimento questa richiesta.

Se l'elemento accessibile è basato su HWND, È possibile usare IAccPropServices::D ecomposeHwndIdentityString per estrarre HWND/idObject/idChild dalla stringa identity.

Se il callback ha un valore da restituire per la proprietà specificata, deve restituirlo in pvarValue e impostare pfHasProp su TRUE. In caso contrario , deve impostare pvarValue su VT_EMPTY e impostare pfHasProp su FALSE. In questo secondo caso, il puntatore dell'interfaccia IAccessible originale verrà usato per ottenere un valore per questa proprietà.

Requisiti