Metodo IAccPropServices::SetPropValue (oleacc.h)

Articolo
02/29/2024

Usare SetPropValue per identificare l'elemento accessibile da annotare, specificare la proprietà da annotare e specificare un nuovo valore per tale proprietà.

Se gli sviluppatori del server conoscono HWND dell'elemento accessibile che vogliono annotare, possono usare uno dei metodi seguenti:

Sintassi

HRESULT SetPropValue(
  [in] const BYTE *pIDString,
  [in] DWORD      dwIDStringLen,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

Parametri

[in] pIDString

Tipo: const BYTE*

Identifica l'elemento accessibile da annotare.

[in] dwIDStringLen

Tipo: DWORD

Specifica la lunghezza della stringa identificata dal parametro pIDString.

[in] idProp

Tipo: MSAAPROPID

Specifica la proprietà dell'elemento accessibile da annotare.

[in] var

Tipo: VARIANT

Specifica un nuovo valore per la proprietà.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se idProp non è una proprietà supportata, se var non è un tipo supportato per tale proprietà o se la stringa identity non è valida.

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

Commenti

Per un elenco di proprietà supportate e dei relativi tipi previsti, vedere la sezione del supporto. Si noti che attualmente alcune proprietà sono supportate solo quando viene usato un callback e non è possibile specificare direttamente usando questo metodo.

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	Accessibilità attiva 2.0 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 98

Condividi tramite