Metodo IAccPropServices::ClearHwndProps (oleacc.h)

Questo metodo esegue il wrapping di SetPropValue, SetPropServer e ClearProps e fornisce un punto di ingresso pratico per i chiamanti che annotano gli elementi accessibili basati su HWND.

Sintassi

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

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] paProps

Tipo: const MSAAPROPID*

Specifica una matrice di proprietà da reimpostare. Queste proprietà torneranno al comportamento predefinito visualizzato prima dell'annotazione.

[in] cProps

Tipo: int

Specifica il numero di proprietà nella matrice paProps.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK, anche se le proprietà specificate non sono mai state annotate nell'oggetto accessibile; la cancellazione delle proprietà già cancellate è considerata un esito positivo.

Restituisce E_INVALIDARG se una delle proprietà nella matrice paProps non è supportata.

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

Per le descrizioni dei valori restituiti, vedere il metodo SetPropValue, SetPropServer o ClearProps corrispondente.

Commenti

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

Inoltre , SetHwndPropStr accetta una stringa Unicode regolare come parametro; il chiamante non deve allocare appositamente un BSTR.

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

Vedi anche

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr