Метод IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)

Статья
03/05/2024

Уведомляет активный объект на месте при активации или деактивации окна документа контейнера.

Синтаксис

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