IOleInPlaceSiteEx::RequestUIActivate-Methode (ocidl.h)

Benachrichtigt den Container, dass das Objekt im Begriff ist, den "UI-aktiv"-Zustand einzugeben.

Syntax

HRESULT RequestUIActivate();

Rückgabewert

Diese Methode gibt S_OK zurück, wenn das Objekt den Aktivierungsprozess fortsetzen und IOleInPlaceSite::OnUIActivate aufrufen kann. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
S_FALSE	Das Objekt kann nicht in den Ui-aktiv-Zustand gelangen. Das -Objekt muss IOleInPlaceSite::OnUIDeactivate aufrufen, damit der Container die erforderliche Verarbeitung durchführen kann, um den Fokus wiederherzustellen.
E_FAIL	Fehler beim Vorgang.

Hinweise

Ein -Objekt ruft diese Methode auf, um zu bestimmen, ob es in den Ui-aktiv-Zustand wechseln kann, und um den Container darüber zu benachrichtigen, dass er diesen Übergang vornehmen wird. Der Container kann S_FALSE zurückgeben, um diese Anforderung zu verweigern, z. B. wenn der Endbenutzer den Vorgang abgebrochen hat oder wenn das derzeit aktive Objekt seinen aktiven Zustand nicht aufgibt.

Wenn das Objekt IOleInPlaceSiteEx::RequestUIActivate nicht aufruft, verarbeitet der Container die Datenüberprüfung und löst Enter- und Exit-Ereignisse von IOleInPlaceSite::OnUIActivate aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IOleInPlaceSite::OnUIActivate

IOleInPlaceSite::OnUIDeactivate

IOleInPlaceSiteEx