IPreviewHandler::QueryFocus-Methode (shobjidl_core.h)

  • Artikel

Weist den Vorschauhandler an, den HWND vom Aufrufen der GetFocus-Funktion zurückzugeben.

Syntax

HRESULT QueryFocus(
  [out] HWND *phwnd
);

Parameter

[out] phwnd

Typ: HWND*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den HWND, der vom Aufrufen der GetFocus-Funktion aus dem Vordergrundthread des Vorschauhandlers zurückgegeben wird.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ist erforderlich, da die GetFocus-Funktion nur erfolgreich sein kann, wenn der Fokus auf einem Fenster liegt, das vom aufrufenden Thread erstellt wurde. Diese Methode wird vom Host verwendet, um die Tabulatorreihenfolge zu verwalten und tabstopps in und aus den Fenstern des Vorschauhandlers zu unterstützen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
Verteilbare Komponente Windows Search 4 oder höher