Поделиться через


Функция AccessibleObjectFromWindow (oleacc.h)

Извлекает адрес указанного интерфейса для объекта, связанного с указанным окном.

Синтаксис

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

Параметры

[in] hwnd

Тип: HWND

Указывает дескриптор окна, для которого требуется извлечь объект. Чтобы получить указатель интерфейса на курсор или объект курсора, укажите ЗНАЧЕНИЕ NULL и используйте соответствующий идентификатор объекта в dwObjectID.

[in] dwId

Тип: DWORD

Указывает идентификатор объекта. Это значение является одной из констант стандартного идентификатора объекта или идентификатором пользовательского объекта, например OBJID_NATIVEOM, который является идентификатором объекта для собственной объектной модели Office. Дополнительные сведения о OBJID_NATIVEOM см. в разделе Примечания этой статьи.

[in] riid

Тип: REFIID

Указывает идентификатор ссылки на запрошенный интерфейс. Это значение либо IID_IAccessible, либо IID_IDispatch, но оно также может быть IID_IUnknown или IID любого интерфейса, который должен поддерживать объект.

[out] ppvObject

Тип: void**

Адрес переменной указателя, которая получает адрес указанного интерфейса.

Возвращаемое значение

Тип: STDAPI

Возвращает значение S_OK, если операция завершилась успешно.

В случае успеха возвращает один из следующих или другой стандартный код ошибки COM.

Код возврата Описание
E_INVALIDARG
Аргумент является недопустимым.
E_NOINTERFACE
Запрошенный интерфейс не поддерживается.

Комментарии

Клиенты вызывают эту функцию для получения адреса объекта IAccess, IDispatch, IEnumVARIANT, IUnknown или другого поддерживаемого указателя интерфейса.

Как и в случае с другими методами и функциями IAccess , клиенты могут получать ошибки для указателей интерфейса IAccess из-за действия пользователя. Дополнительные сведения см. в разделе Получение ошибок для указателей интерфейса IAccessible.

Клиенты используют эту функцию для получения доступа к собственной объектной модели Microsoft Office 2000. Собственная объектная модель предоставляет клиентам сведения о специальных возможностях в документе или клиентской области приложения Office, которые не предоставляются Microsoft Active Accessibility.

Чтобы получить указатель интерфейса IDispatch на класс, поддерживаемый собственной объектной моделью, укажите OBJID_NATIVEOM в dwObjectID. При использовании этого идентификатора объекта параметр hwnd должен соответствовать следующим типам оконных классов.

Приложения Office Класс Window IDispatch: указатель на
Word _WwG Окно
Excel EXCEL7 Окно
PowerPoint paneClassDC DocumentWindow
Панели команд MsoCommandBar CommandBar
 

Обратите внимание, что указанные выше классы окон соответствуют самому внутреннему окну документа или окну панели. Дополнительные сведения об объектной модели Office см. в руководстве программиста Microsoft Office 2000/Visual Basic.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header oleacc.h
Библиотека Oleacc.lib
DLL Oleacc.dll
Распространяемые компоненты Активные специальные возможности 1.3 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 95

См. также раздел

AccessibleObjectFromEvent

AccessibleObjectFromPoint

IAccessible

IDispatch