Метод IOleWindow::GetWindow (oleidl.h)
Извлекает дескриптор для одного из окон, участвующих в активации на месте (окно фрейма, документа, родительского окна или окна объектов на месте).
Синтаксис
HRESULT GetWindow(
[out] HWND *phwnd
);
Параметры
[out] phwnd
Указатель на переменную, которая получает дескриптор окна.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
Код возврата | Описание |
---|---|
|
Объект не является оконным. |
|
Указанное значение fEnterMode недопустимо. |
|
Недостаточно доступной памяти для этой операции. |
|
Произошла непредвиденная ошибка. |
Комментарии
Иерархию окон составляют пять типов окон. Если объект активен на месте, он имеет доступ к некоторым или всем этим окнам.
Окно | Описание |
---|---|
Frame | Самое внешнее окно main, в котором находится меню main приложения-контейнера. |
Документ | Окно, в котором отображается составной документ, содержащий внедренный объект для пользователя. |
Панель | Подокно окна документа, содержащего представление объекта. Применимо только для приложений с окнами с разделенной панелью. |
Parent | Окно контейнера, содержащее представление этого объекта. Приложение-объект устанавливает свое окно в качестве дочернего элемента этого окна. |
на месте; | Окно, содержащее активный объект на месте. Приложение-объект создает это окно и устанавливает его в качестве дочернего элемента окна штриховки, которое является дочерним по отношению к родительскому окну контейнера. |
Каждый тип окна имеет разную роль в архитектуре активации на месте. Однако нет необходимости использовать отдельное физическое окно для каждого типа. Многие приложения-контейнеры используют одно и то же окно для своих фреймов, документов, панелей и родительских окон.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | oleidl.h |