IOleControlSite::Metode TranslateAccelerator (ocidl.h)

Meneruskan penekanan tombol ke situs kontrol untuk diproses.

Sintaks

HRESULT TranslateAccelerator(
  [in] MSG   *pMsg,
  [in] DWORD grfModifiers
);

Parameter

[in] pMsg

Penunjuk ke struktur MSG yang menjelaskan penekanan tombol yang akan diproses.

[in] grfModifiers

Bendera yang menjelaskan status tombol Kontrol, Alt, dan Shift. Nilai bendera dapat berupa nilai enumerasi KEYMODIFIERS yang valid.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode Deskripsi
S_OK
Kontainer memproses pesan.
S_FALSE
Kontainer tidak memproses pesan. Nilai ini juga harus dikembalikan dalam semua kasus kesalahan lainnya selain E_NOTIMPL.
E_NOTIMPL
Kontainer tidak menerapkan dukungan akselerator.

Keterangan

Metode ini dipanggil oleh kontrol yang dapat menjadi UI-active. Dalam kasus seperti itu, kontrol dapat memproses semua penekanan tombol terlebih dahulu melalui IOleInPlaceActiveObject::TranslateAccelerator, sesuai dengan aturan Dokumen Gabungan OLE normal. Di dalam metode itu, kontrol dapat memberikan kontainer pesan tertentu untuk diproses terlebih dahulu dengan memanggil IOleControlSite::TranslateAccelerator dan menggunakan nilai pengembalian untuk menentukan apakah ada pemrosesan yang terjadi. Jika tidak, kontrol selalu memproses pesan terlebih dahulu. Jika kontrol tidak menggunakan penekanan tombol sebagai akselerator, kontrol meneruskan penekanan tombol ke kontainer melalui metode ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header ocidl.h

Lihat juga

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator