Bagikan melalui

Metode ITfKeystrokeMgr::KeyUp (msctf.h)

  • Artikel

Meneruskan peristiwa kunci ke manajer penekanan tombol.

Sintaks

HRESULT KeyUp(
  [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_KEYUP.

[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_KEYUP.

[out] pfEaten

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

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
 Metode berhasil.
S_FALSE
 Tidak ada sink peristiwa kunci yang diinstal.
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 diimplementasikan.


if(msg.message == WM_KEYUP)
{
    if( pKeyboardMgr->TestKeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && fEaten 
        && pKeyboardMgr->KeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && 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 keystroke tidak menangani peristiwa kunci, itu meneruskan peristiwa kunci ke layanan teks dengan panggilan ke layanan teks metode ITfKeyEventSink::OnKeyUp .

Persyaratan

Persyaratan Nilai
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

Lihat juga