IShellView::UIActivate-Methode (shobjidl_core.h)

  • Artikel

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)

Weitere Informationen

IShellView