IPreviewHandlerFrame：：GetWindowContext 方法 (shobjidl_core.h)

取得預覽主機的鍵盤快捷方式清單。

語法

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

參數

[out] pinfo

類型： PREVIEWHANDLERFRAMEINFO*

PREVIEWHANDLERFRAMEINFO 結構的指標，可接收快捷鍵數據表資訊。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

快速鍵表格是鍵盤快捷方式的清單，以及主機應該執行的命令。 作為優化，預覽處理程式接著可以查看它收到的擊鍵、針對快捷鍵表檢查它們，以查看主機是否對它們感興趣，並視需要將它們轉送至 ，忽略結構中的命令。 從 IPreviewHandlerFrame：：GetWindowContext 傳回的快捷鍵表只包含按鍵，而且不包含有效的命令專案。 預覽處理程式也可以略過此優化，只要針對每個擊鍵呼叫 IPreviewHandlerFrame：：TranslateAccelerator 即可。 當預覽處理程序終結時，必須使用 DestroyAcceleratorTable 函式釋放快捷鍵數據表。

這個方法應該在預覽處理程式呼叫 SetSite 且結果已快取以供預覽處理程式稍後使用時呼叫。 在低完整性模式中執行的預覽處理程式無法呼叫這個方法。 這些預覽處理程式一律必須針對每個擊鍵呼叫 IPreviewHandlerFrame：：TranslateAccelerator 。

規格需求

另請參閱

IPreviewHandlerFrame

IPreviewHandlerFrame：：TranslateAccelerator