Función AccessibleObjectFromWindow (oleacc.h)

Recupera la dirección de la interfaz especificada para el objeto asociado a la ventana especificada.

Sintaxis

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

Parámetros

[in] hwnd

Tipo: HWND

Especifica el identificador de una ventana para la que se va a recuperar un objeto. Para recuperar un puntero de interfaz al cursor o al objeto de intercalación, especifique NULL y use el identificador de objeto adecuado en dwObjectID.

[in] dwId

Tipo: DWORD

Especifica el id. de objeto. Este valor es una de las constantes de identificador de objeto estándar o un identificador de objeto personalizado, como OBJID_NATIVEOM, que es el identificador de objeto del modelo de objetos nativo de Office. Para obtener más información sobre OBJID_NATIVEOM, vea la sección Comentarios de este tema.

[in] riid

Tipo: REFIID

Especifica el identificador de referencia de la interfaz solicitada. Este valor es IID_IAccessible o IID_IDispatch, pero también puede ser IID_IUnknown o el IID de cualquier interfaz que se espera que admita el objeto.

[out] ppvObject

Tipo: void**

Dirección de una variable de puntero que recibe la dirección de la interfaz especificada.

Valor devuelto

Tipo: STDAPI

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve uno de los siguientes u otro código de error COM estándar.

Código devuelto	Descripción
E_INVALIDARG	Un argumento no es válido.
E_NOINTERFACE	La interfaz solicitada no es compatible.

Comentarios

Los clientes llaman a esta función para recuperar la dirección de IAccessible de un objeto, IDispatch, IEnumVARIANT, IUnknown u otro puntero de interfaz compatible.

Al igual que con otros métodos y funciones IAccessible , los clientes pueden recibir errores para punteros de interfaz IAccessible debido a una acción del usuario. Para obtener más información, vea Recepción de errores para punteros de interfaz IAccessible.

Los clientes usan esta función para obtener acceso al modelo de objetos nativo de Microsoft Office 2000. El modelo de objetos nativo proporciona a los clientes información de accesibilidad sobre el documento o el área de cliente de una aplicación de Office que microsoft Active Accessibility no expone.

Para obtener un puntero de interfaz IDispatch a una clase compatible con el modelo de objetos nativo, especifique OBJID_NATIVEOM en dwObjectID. Al usar este identificador de objeto, el parámetro hwnd debe coincidir con los siguientes tipos de clase de ventana.

Aplicación de Office	Clase Window	Puntero de IDispatch a
Word	_WwG	Periodo
Excel	EXCEL7	Periodo
PowerPoint	paneClassDC	DocumentWindow
Barras de comandos	MsoCommandBar	CommandBar

 

Tenga en cuenta que las clases de ventana anteriores corresponden a la ventana de documento o panel más interna. Para obtener más información sobre el modelo de objetos de Office, vea la Guía del programador de Microsoft Office 2000/Visual Basic.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h
Library	Oleacc.lib
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95

Consulte también

AccessibleObjectFromEvent

AccessibleObjectFromPoint

IAccessible

IDispatch