Метод IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)
Уведомляет активный объект на месте при активации или деактивации окна документа контейнера.
Синтаксис
HRESULT OnDocWindowActivate(
[in] BOOL fActivate
);
Параметры
[in] fActivate
Состояние окна дочернего документа MDI. Если этот параметр имеет значение TRUE, окно находится в действии активации; Если оно имеет значение FALSE, оно находится в акте деактивации.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении.
Комментарии
Примечания к вызывающим абонентам
Вызовите IOleInPlaceActiveObject::OnDocWindowActivate , если дочернее окно документа MDI активировано или деактивировано, а объект в данный момент является активным объектом для документа.Примечания для разработчиков
В этот метод следует включить код, который устанавливает средства на уровне фрейма во время активации объекта. К этим средствам относятся общее составное меню и (или) необязательные панели инструментов и декоративные элементы фрейма. Затем следует сосредоточиться. При деактивации объект должен удалить средства на уровне кадра. Обратите внимание, что если не вызывать IOleInPlaceUIWindow::SetBorderSpace с параметром pborderwidths со значением NULL, можно избежать необходимости повторного согласования пространства границы.При выполнении IOleInPlaceActiveObject::OnDocWindowActivate не выполняйте вызовы функций PeekMessage или GetMessage или диалогового окна. Это может привести к взаимоблокировки системы. Существуют дополнительные ограничения, на которые можно вызывать методы и функции интерфейса OLE из IOleInPlaceActiveObject::OnDocWindowActivate.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | oleidl.h |