Funzione AccessibleObjectFromWindow (oleacc.h)

Articolo
08/25/2023

Recupera l'indirizzo dell'interfaccia specificata per l'oggetto associato alla finestra specificata.

Sintassi

HRESULT AccessibleObjectFromWindow(
  [in]  HWND   hwnd,
  [in]  DWORD  dwId,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Parametri

[in] hwnd

Tipo: HWND

Specifica l'handle di una finestra per cui recuperare un oggetto. Per recuperare un puntatore di interfaccia all'oggetto cursore o cursore, specificare NULL e usare l'ID oggetto appropriato in dwObjectID.

[in] dwId

Tipo: DWORD

Specifica l'ID di oggetto. Questo valore è una delle costanti dell'identificatore di oggetto standard o un ID oggetto personalizzato, ad esempio OBJID_NATIVEOM, ovvero l'ID oggetto per il modello a oggetti nativo di Office. Per altre informazioni su OBJID_NATIVEOM, vedere la sezione Osservazioni in questo argomento.

[in] riid

Tipo: REFIID

Specifica l'identificatore di riferimento dell'interfaccia richiesta. Questo valore è IID_IAccessible o IID_IDispatch, ma può anche essere IID_IUnknown o l'IID di qualsiasi interfaccia che l'oggetto deve supportare.

[out] ppvObject

Tipo: void**

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

Valore restituito

Tipo: STDAPI

Se ha esito positivo, restituisce S_OK.

Se l'operazione non riesce, restituisce uno dei codici di errore COM seguenti o un altro codice di errore STANDARD.

Codice restituito	Descrizione
E_INVALIDARG	Un argomento non è valido.
E_NOINTERFACE	L'interfaccia richiesta non è supportata.

Commenti

I client chiamano questa funzione per recuperare l'indirizzo di un oggetto IAccessible, IDispatch, IEnumVARIANT, IUnknown o un altro puntatore di interfaccia supportato.

Come con altri metodi e funzioni IAccessible , i client potrebbero ricevere errori per i puntatori di interfaccia IAccessible a causa di un'azione dell'utente. Per altre informazioni, vedere Ricezione di errori per puntatori di interfaccia IAccessible.

I client usano questa funzione per ottenere l'accesso al modello a oggetti nativo di Microsoft Office 2000. Il modello a oggetti nativo fornisce ai client informazioni di accessibilità relative al documento o all'area client di un'applicazione di Office non esposta da Microsoft Active Accessibility.

Per ottenere un puntatore all'interfaccia IDispatch a una classe supportata dal modello a oggetti nativo, specificare OBJID_NATIVEOM in dwObjectID. Quando si usa questo identificatore di oggetto, il parametro hwnd deve corrispondere ai tipi di classe della finestra seguenti.

Applicazione di Office	Classe Window	Puntatore IDispatch a
Word	_WwG	Finestra
Excel	EXCEL7	Finestra
PowerPoint	paneClassDC	DocumentWindow
Barre dei comandi	MsoCommandBar	CommandBar

Si noti che le classi di finestra precedenti corrispondono alla finestra o alla finestra del riquadro più interna del documento. Per altre informazioni sul modello a oggetti di Office, vedere la Guida per programmatori di Microsoft Office 2000/Visual Basic.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedi anche

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

Idispatch

Condividi tramite