Metodo IAccPropServices::ClearProps (oleacc.h)

Articolo
03/08/2023

I server usano ClearProps per ripristinare i valori predefiniti alle proprietà degli elementi accessibili annotati in precedenza.

Se i server conoscono il valore HWND dell'oggetto che vogliono cancellare, possono usare IAccPropServices::ClearHwndProps.

Sintassi

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parametri

[in] pIDString

Tipo: const BYTE*

Identifica l'elemento accessibile di cui annullare l'annotazione.

[in] dwIDStringLen

Tipo: DWORD

Lunghezza di pIDString.

[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

Dimensioni della matrice paProps .

Valore restituito

Tipo: HRESULT

In caso di esito positivo, restituisce S_OK, anche se le proprietà specificate non sono mai state annotate sull'oggetto accessibile; la cancellazione delle proprietà già cancellate viene considerata un'operazione riuscita.

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 memoria insufficiente.

Commenti

Per un elenco delle proprietà supportate e dei relativi tipi previsti, vedere la sezione relativa al supporto.

Se si cancella l'annotazione per una proprietà, tutte le risorse associate verranno rilasciate. Se è stato usato un server di proprietà di callback (vedere SetPropServer), verrà rilasciato.

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

Condividi tramite