Metodo IAccPropServices::SetHwndProp (oleacc.h)

Articolo
02/29/2024

Questo metodo esegue il wrapping di SetPropValue, fornendo un punto di ingresso pratico per i chiamanti che annotano gli elementi accessibili basati su HWND. Se il nuovo valore è una stringa, è possibile usare invece IAccPropServices::SetHwndPropStr .

Sintassi

HRESULT SetHwndProp(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

Parametri

[in] hwnd

Tipo: HWND

Identifica l'elemento accessibile da annotare. Sostituisce la stringa di identità.

[in] idObject

Tipo: DWORD

Identifica l'elemento accessibile da annotare. Sostituisce la stringa di identità.

[in] idChild

Tipo: DWORD

Identifica l'elemento accessibile da annotare. Sostituisce la stringa di identità.

[in] idProp

Tipo: MSAAPROPID

Specifica la proprietà da annotare dell'elemento.

[in] var

Tipo: VARIANT

Specifica un nuovo valore per tale proprietà.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se la proprietà idProp non è supportata.

Può restituire altri codici di errore in condizioni di errore eccezionali, ad esempio memoria insufficiente.

Commenti

Utilizzando questo metodo, il chiamante non deve ottenere una stringa di identità; può specificare direttamente i parametri hwnd, idObject e idChild .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h (include OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
Componente ridistribuibile	Active Accessibility 2.0 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 98