Metodo IAccPropServices::SetPropValue (oleacc.h)

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:

• IAccPropServices::SetHwndPropStr,
• IAccPropServices::SetHwndProp o
• IAccPropServices::SetHwndPropServer

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