IShellView::UIActivate-Methode (shobjidl_core.h)
Wird aufgerufen, wenn der Aktivierungsstatus des Ansichtsfensters durch ein Ereignis geändert wird, das nicht durch die Shellansicht selbst verursacht wird. Wenn beispielsweise die TAB-TASTE gedrückt wird, wenn die Struktur den Fokus hat, sollte der Ansicht der Fokus gegeben werden.
Syntax
HRESULT UIActivate(
UINT uState
);
Parameter
uState
Typ: UINT
Flag, das den Aktivierungsstatus des Fensters angibt. Dieser Parameter kann einen der folgenden Werte annehmen.
SVUIA_ACTIVATE_FOCUS
Windows Explorer hat gerade das Ansichtsfenster mit dem Eingabefokus erstellt. Dies bedeutet, dass die Shellansicht in der Lage sein sollte, Menüelemente festzulegen, die für den fokussierten Zustand geeignet sind.
SVUIA_ACTIVATE_NOFOCUS
Die Shellansicht verliert den Eingabefokus oder wurde gerade ohne eingabefokus erstellt. Die Shellansicht sollte in der Lage sein, Menüelemente festzulegen, die für den nicht fokussierten Zustand geeignet sind. Dies bedeutet, dass keine auswahlspezifischen Elemente hinzugefügt werden sollten.
SVUIA_DEACTIVATE
Windows Explorer ist dabei, das Shellansichtsfenster zu zerstören. Die Shellansicht sollte alle erweiterten Benutzeroberflächen entfernen. Dies sind in der Regel zusammengeführte Menüs und zusammengeführte moduslose Popupfenster.
SVUIA_INPLACEACTIVATE
Die Shellansicht ist ohne Fokus aktiv. Dieses Flag wird nur verwendet, wenn UIActivate über die IShellView2-Schnittstelle verfügbar gemacht wird.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen vom COM definierten Fehlerwert.
Hinweise
Vor dem Remerging von Menüelementen bindet die Shellansicht in der Regel die WM_SETFOCUS Nachricht ein und ruft die OnViewWindowActive-Methode auf. Die Shellansicht sollte die NM_KILLFOCUS-Nachricht nicht an die Erneuteinbindung von Menüelementen binden.
Hinweise zum Aufrufen von Anwendungen
Rufen Sie diese Methode auf, um die Ansicht einer Aktivierungsstatusänderung zu informieren.Hinweise zu Implementierern
Verwenden Sie diese Methode, um den Aktivierungsstatus nachzuverfolgen und jedes Verhalten nach Bedarf zu ändern.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (einschließlich Shobjidl.h) |
| DLL | Shell32.dll (Version 4.0 oder höher) |