Метод IOleInPlaceSiteEx::RequestUIActivate (ocidl.h)
Уведомляет контейнер, что объект собирается перейти в состояние активности пользовательского интерфейса.
Синтаксис
HRESULT RequestUIActivate();
Возвращаемое значение
Этот метод возвращает S_OK, если объект может продолжить процесс активации и вызвать IOleInPlaceSite::OnUIActivate. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Объект не может войти в состояние пользовательский интерфейс active. Объект должен вызвать IOleInPlaceSite::OnUIDeactivate , чтобы контейнер смог выполнить необходимую обработку для восстановления фокуса. |
|
Операция не удалась. |
Комментарии
Объект вызывает этот метод, чтобы определить, может ли он перейти в состояние активности пользовательского интерфейса, и уведомить контейнер о том, что он выполняет этот переход. Контейнер может вернуть S_FALSE, чтобы отклонить этот запрос, например, если пользователь отменил операцию или если текущий активный объект не выйдет из своего активного состояния.
Если объект не вызывает IOleInPlaceSiteEx::RequestUIActivate, контейнер обрабатывает проверку данных и вызывает события Ввод и Выход из IOleInPlaceSite::OnUIActivate.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ocidl.h |