Метод IOleInPlaceSiteEx::OnInPlaceActivateEx (ocidl.h)
Вызывается внедренным объектом для определения необходимости перерисовки при активации.
Синтаксис
HRESULT OnInPlaceActivateEx(
[out] BOOL *pfNoRedraw,
[in] DWORD dwFlags
);
Параметры
[out] pfNoRedraw
Указатель на переменную, получающую текущее состояние перерисовки. Состояние равно TRUE , если объект не должен перерисовывать себя после активации, и false в противном случае. Объекты без окон обычно не нуждаются в значении, возвращаемом этим параметром, и они могут передавать указатель NULL , чтобы сохранить контейнер при вычислении этого значения.
[in] dwFlags
Указывает, активируется ли объект как объект без окон. Этот параметр принимает значения из перечисления ACTIVATEFLAGS . Дополнительные сведения об объектах без окон см. в разделе IOleInPlaceSiteWindowless .
Возвращаемое значение
Этот метод возвращает S_OK, если контейнер разрешает активацию на месте. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Произошла непредвиденная ошибка. |
Комментарии
Этот метод заменяет IOleInPlaceSite::OnInPlaceActivate. Если используется старый метод, объект всегда должен перерисовывать себя при активации.
Объекты без окон должны использовать этот метод вместо IOleInPlaceSite::OnInPlaceActivate , чтобы уведомить контейнер о том, активируются ли они без окон.
Примечания для разработчиков
Контейнер должен тщательно проверка состояние недействительности объекта, его Z-порядок, обрезку и любые другие соответствующие параметры, чтобы определить соответствующее значение, возвращаемое в pfNoRedraw.Контейнер может кэшировать значение перечисления ACTIVATEFLAGS вместо многократного вызова метода GetWindow в интерфейсе IOleInPlaceObjectWindowless .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ocidl.h |