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

Статья
03/08/2023

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

Синтаксис

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 , клиенты могут получать ошибки для указателей интерфейса 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