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


Метод IOleWindow::GetWindow (oleidl.h)

Извлекает дескриптор для одного из окон, участвующих в активации на месте (окно фрейма, документа, родительского окна или окна объектов на месте).

Синтаксис

HRESULT GetWindow(
  [out] HWND *phwnd
);

Параметры

[out] phwnd

Указатель на переменную, которая получает дескриптор окна.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата Описание
E_FAIL
Объект не является оконным.
E_INVALIDARG
Указанное значение fEnterMode недопустимо.
E_OUTOFMEMORY
Недостаточно доступной памяти для этой операции.
E_UNEXPECTED
Произошла непредвиденная ошибка.

Комментарии

Иерархию окон составляют пять типов окон. Если объект активен на месте, он имеет доступ к некоторым или всем этим окнам.

Окно Описание
Frame Самое внешнее окно main, в котором находится меню main приложения-контейнера.
Документ Окно, в котором отображается составной документ, содержащий внедренный объект для пользователя.
Панель Подокно окна документа, содержащего представление объекта. Применимо только для приложений с окнами с разделенной панелью.
Parent Окно контейнера, содержащее представление этого объекта. Приложение-объект устанавливает свое окно в качестве дочернего элемента этого окна.
на месте; Окно, содержащее активный объект на месте. Приложение-объект создает это окно и устанавливает его в качестве дочернего элемента окна штриховки, которое является дочерним по отношению к родительскому окну контейнера.
 

Каждый тип окна имеет разную роль в архитектуре активации на месте. Однако нет необходимости использовать отдельное физическое окно для каждого типа. Многие приложения-контейнеры используют одно и то же окно для своих фреймов, документов, панелей и родительских окон.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header oleidl.h

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

IOleWindow