Metodo IAccPropServices::SetHwndPropServer (oleacc.h)

Articolo
08/25/2023

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

Sintassi

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

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à che dovrà essere gestita dall'oggetto callback specificato.

[in] cProps

Tipo: int

Specifica il numero di proprietà nella matrice paProps.

[in] pServer

Tipo: IAccPropServer*

Specifica l'oggetto callback che verrà richiamato quando un client richiede una delle proprietà sottoposte a override.

[in] annoScope

Tipo: AnnoScope

Può essere ANNO_THIS, che indica che l'annotazione influisce solo sull'elemento accessibile indicato, oppure ANNO_CONTAINER, che indica che l'annotazione si applica all'elemento e ai relativi elementi figlio diretti.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se una delle proprietà nella matrice paProps non è supportata, se la stringa identity non è valida o se annoScope non è uno dei ANNO_THIS o ANNO_CONTAINER.

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