Compartir a través de

Función AccessibleObjectFromWindow (oleacc.h)

  • Artículo

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