Metode IPreviewHandlerFrame::GetWindowContext (shobjidl_core.h)

Mendapatkan daftar pintasan keyboard untuk host pratinjau.

Sintaks

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

Parameter

[out] pinfo

Jenis: PREVIEWHANDLERFRAMEINFO*

Penunjuk ke struktur PREVIEWHANDLERFRAMEINFO yang menerima informasi tabel akselerator.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Tabel akselerator adalah daftar pintasan keyboard dan perintah yang harus dijalankan host. Sebagai pengoptimalan, handler pratinjau kemudian dapat melihat penekanan tombol yang diterimanya, memeriksanya terhadap tabel akselerator untuk melihat apakah host tertarik padanya, dan meneruskannya jika sesuai, mengabaikan perintah dalam struktur. Tabel akselerator yang dikembalikan dari IPreviewHandlerFrame::GetWindowContext, hanya berisi penekanan tombol dan tidak berisi entri perintah yang valid. Penangan pratinjau juga dapat melewati pengoptimalan ini dan hanya memanggil IPreviewHandlerFrame::TranslateAccelerator untuk setiap penekanan tombol. Ketika handler pratinjau dihancurkan, tabel akselerator harus dikosongkan menggunakan fungsi DestroyAcceleratorTable .

Metode ini harus dipanggil pada titik ketika handler pratinjau telah disebut SetSite dan hasilnya telah di-cache untuk digunakan nanti oleh handler pratinjau. Metode ini tidak dapat dipanggil oleh penangan pratinjau yang berjalan dalam mode integritas rendah. Handler pratinjau tersebut harus selalu memanggil IPreviewHandlerFrame::TranslateAccelerator untuk setiap penekanan tombol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
Redistribusi	Windows Search 4 atau yang lebih baru

Lihat juga

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator