Funzione AccessibleObjectFromWindow (oleacc.h)

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.

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.

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

Vedi anche

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

Idispatch