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

Метод IOleInPlaceSiteEx::RequestUIActivate (ocidl.h)

  • Статья

Уведомляет контейнер, что объект собирается перейти в состояние активности пользовательского интерфейса.

Синтаксис

HRESULT RequestUIActivate();

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

Этот метод возвращает S_OK, если объект может продолжить процесс активации и вызвать IOleInPlaceSite::OnUIActivate. Другие возможные возвращаемые значения включают следующее.

Код возврата Описание
S_FALSE
 Объект не может войти в состояние пользовательский интерфейс active. Объект должен вызвать IOleInPlaceSite::OnUIDeactivate , чтобы контейнер смог выполнить необходимую обработку для восстановления фокуса.
E_FAIL
 Операция не удалась.

Комментарии

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

Если объект не вызывает IOleInPlaceSiteEx::RequestUIActivate, контейнер обрабатывает проверку данных и вызывает события Ввод и Выход из IOleInPlaceSite::OnUIActivate.

Требования

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

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

IOleInPlaceSite::OnUIActivate

IOleInPlaceSite::OnUIDeactivate

IOleInPlaceSiteEx