IPreviewHandlerFrame::GetWindowContext-Methode (shobjidl_core.h)
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 |