IPreviewHandlerFrame::GetWindowContext-Methode (shobjidl_core.h)

  • Artikel

Ruft eine Liste der Tastenkombinationen für den Vorschauhost ab.

Syntax

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

Parameter

[out] pinfo

Typ: PREVIEWHANDLERFRAMEINFO*

Ein Zeiger auf eine PREVIEWHANDLERFRAMEINFO-Struktur , die Zugriffstastentabelleninformationen empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Eine Zugriffstastentabelle ist eine Liste mit Tastenkombinationen und den Befehlen, die vom Host ausgeführt werden sollen. Als Optimierung kann der Vorschauhandler dann die empfangenen Tastatureingaben betrachten, sie anhand der Beschleunigertabelle überprüfen, um festzustellen, ob der Host daran interessiert ist, und sie ggf. weiterleiten, wobei die Befehle in der Struktur ignoriert werden. Die von IPreviewHandlerFrame::GetWindowContext zurückgegebene Acceleratortabelle enthält nur Tastenanschläge und enthält keine gültigen Befehlseinträge. Vorschauhandler können diese Optimierung auch überspringen und einfach IPreviewHandlerFrame::TranslateAccelerator für jede Tastatureingabe aufrufen. Wenn der Vorschauhandler zerstört wird, muss die Acceleratortabelle mithilfe der DestroyAcceleratorTable-Funktion freigegeben werden.

Diese Methode sollte zu dem Zeitpunkt aufgerufen werden, an dem der Vorschauhandler SetSite aufgerufen hat und die Ergebnisse zur späteren Verwendung durch den Vorschauhandler zwischengespeichert wurden. Diese Methode kann nicht von Vorschauhandlern aufgerufen werden, die im Modus mit niedriger Integrität ausgeführt werden. Diese Vorschauhandler müssen immer IPreviewHandlerFrame::TranslateAccelerator für jeden Tastenanschlag aufrufen.

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 (shobjidl.h einschließen)
Verteilbare Komponente Windows Search 4 oder höher

Weitere Informationen

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator