Funzione CreateStdAccessibleProxyA (oleacc.h)

Articolo
11/20/2024

Crea un oggetto accessibile con le proprietà e i metodi della classe specificata dell'elemento dell'interfaccia utente fornita dal sistema.

Sintassi

HRESULT CreateStdAccessibleProxyA(
  [in]  HWND   hwnd,
  [in]  LPCSTR pClassName,
  [in]  LONG   idObject,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Parametri

[in] hwnd

Tipo: HWND

Handle finestra dell'elemento dell'interfaccia utente fornito dal sistema (un controllo) per il quale viene creato un oggetto accessibile.

[in] pClassName

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null del nome della classe di un elemento dell'interfaccia utente fornito dal sistema per il quale viene creato un oggetto accessibile. Il nome della classe finestra è uno dei controlli comuni (definiti in Comctl32.dll), controlli predefiniti (definiti in User32.dll) o elementi della finestra.

[in] idObject

Tipo: LONG

ID oggetto. Questo valore è in genere OBJID_CLIENT, che è una delle costanti dell'identificatore di oggetto, ma può essere un altro identificatore di oggetto.

[in] riid

Tipo: REFIID

Identificatore di riferimento dell'interfaccia richiesta. Questo valore è uno dei seguenti: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT o IID_IUnknown.

[out] ppvObject

Tipo: void**

Indirizzo di una variabile puntatore che riceve l'indirizzo dell'interfaccia specificata.

Valore restituito

Tipo: STDAPI

In caso di esito positivo, restituisce S_OK.

In caso di esito negativo, restituisce un codice di errore COM standard .

Osservazioni

Le applicazioni server chiamano questa funzione quando contengono un controllo personalizzato simile a un controllo fornito dal sistema. Le applicazioni server possono chiamare createStdAccessibleProxy per eseguire l'override dei metodi e delle proprietà IAccessible in base alle esigenze per trovare le corrispondenze con i controlli personalizzati. In alternativa, gli sviluppatori di server possono usare l'annotazione dinamica per eseguire l'override di proprietà specifiche senza dover usare tecniche di sottoclasse difficili necessarie con CreateStdAccessibleProxy. Gli sviluppatori di server devono comunque usare CreateStdAccessibleProxy per modifiche strutturali, ad esempio nascondere un elemento figlio o creare un elemento figlio segnaposto. Questo approccio consente agli sviluppatori di server di implementare completamente tutte le proprietà e i metodi IAccessible.

Questa funzione è simile a CreateStdAccessibleObject, ad eccezione del fatto che CreateStdAccessibleObject usa sempre il nome della classe associato al hwnd, mentre CreateStdAccessibleProxy consente di specificare il nome della classe come parametro.

Usare CreateStdAccessibleProxy per creare un oggetto accessibile per un elemento dell'interfaccia utente superclassato. Quando un elemento dell'interfaccia utente viene sovraclassato, un'applicazione crea un controllo personalizzato con un nome di classe finestra diverso dal controllo predefinito su cui si basa. Poiché il nome della classe associato al parametro hwnd è il nome della classe della finestra superclasse, specificare il nome della classe di base (il nome della classe di sistema su cui è basato il controllo superclassato) in pszClassName.

Nota

L'intestazione oleacc.h definisce CreateStdAccessibleProxy come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	oleacc.h
libreria	Oleacc.lib
dll	Oleacc.dll
Ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedere anche

Appendice A: Riferimenti agli elementi dell'interfaccia utente supportati

CreateStdAccessibleObject

IDispatch

collegamenti per l'esposizione di elementi dell'interfaccia utente personalizzati

Condividi tramite