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 。

規格需求

需求 值
最低支援的用戶端 Windows Vista、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
可轉散發套件 Windows 搜尋 4 或更新版本

另請參閱

IPreviewHandlerFrame

IPreviewHandlerFrame：：TranslateAccelerator