Metode ITfKeystrokeMgr::KeyDown (msctf.h)

Artikel
08/24/2023

Meneruskan peristiwa kunci ke manajer penekanan tombol.

Sintaks

HRESULT KeyDown(
  [in]  WPARAM wParam,
  [in]  LPARAM lParam,
  [out] BOOL   *pfEaten
);

Parameter

[in] wParam

Menentukan kode kunci virtual kunci. Untuk informasi selengkapnya tentang parameter ini, lihat parameter wParam di WM_KEYDOWN.

[in] lParam

Menentukan jumlah berulang, kode pemindaian, bendera extended-key, kode konteks, bendera status kunci sebelumnya, dan bendera status transisi kunci. Untuk informasi selengkapnya tentang parameter ini, lihat parameter lParam di WM_KEYDOWN.

[out] pfEaten

Pointer ke BOOL yang, saat keluar, menunjukkan apakah peristiwa kunci ditangani. Jika nilai ini menerima TRUE, peristiwa kunci ditangani dan peristiwa tidak boleh diteruskan ke aplikasi. Jika nilai ini FALSE, peristiwa kunci tidak ditangani dan peristiwa harus diteruskan ke aplikasi.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Tidak ada sink peristiwa utama yang terinstal.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.

Keterangan

Jika metode ini berhasil dan pfEaten menerima TRUE, aplikasi tidak boleh memproses peristiwa kunci tidak berfungsi. Jika metode ini tidak mengembalikan S_OK atau pfEaten menerima FALSE, aplikasi harus memproses peristiwa kunci tidak berfungsi. Berikut ini adalah contoh bagaimana hal ini diterapkan.


if(msg.message == WM_KEYDOWN)
{
    if( pKeyboardMgr-&gt;TestKeyDown(msg.wParam, msg.lParam, &amp;fEaten) == S_OK 
        &amp;&amp; fEaten 
        &amp;&amp; pKeyboardMgr-&gt;KeyDown(msg.wParam, msg.lParam, &amp;fEaten) == S_OK 
        &amp;&amp; fEaten)
    {
        //The key was handled by the keystroke manager or a TSF text service. Do not pass the key to the application. 
        continue;
    }
    else
    {
        //Let the application process the key. 
    }
}

Jika manajer penekanan kunci tidak menangani peristiwa kunci, itu meneruskan peristiwa kunci ke layanan teks TSF dengan memanggil layanan teks TSF metode ITfKeyEventSink::OnKeyDown .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Bagikan melalui