Fungsi SetFocus (winuser.h)

  • Artikel

Mengatur fokus keyboard ke jendela yang ditentukan. Jendela harus dilampirkan ke antrean pesan utas panggilan.

Sintaks

HWND SetFocus(
  [in, optional] HWND hWnd
);

Parameter

[in, optional] hWnd

Jenis: HWND

Handel ke jendela yang akan menerima input keyboard. Jika parameter ini NULL, penekanan tombol diabaikan.

Nilai kembali

Jenis: HWND

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke jendela yang sebelumnya memiliki fokus keyboard. Jika parameter hWnd tidak valid atau jendela tidak dilampirkan ke antrean pesan utas panggilan, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError.

Kesalahan yang diperluas ERROR_INVALID_PARAMETER (0x57) berarti bahwa jendela dalam status dinonaktifkan.

Keterangan

Fungsi ini mengirimkan pesan WM_KILLFOCUS ke jendela yang kehilangan fokus keyboard dan pesan WM_SETFOCUS ke jendela yang menerima fokus keyboard. Ini juga mengaktifkan jendela yang menerima fokus atau induk jendela yang menerima fokus.

Jika jendela aktif tetapi tidak memiliki fokus, tombol apa pun yang ditekan menghasilkan pesan WM_SYSCHAR, WM_SYSKEYDOWN, atau WM_SYSKEYUP . Jika tombol VK_MENU juga ditekan, bit 30 parameter lParam pesan diatur. Jika tidak, pesan yang dihasilkan tidak memiliki set bit ini.

Dengan menggunakan fungsi AttachThreadInput, utas dapat melampirkan pemrosesan inputnya ke utas lain. Ini memungkinkan utas untuk memanggil SetFocus untuk mengatur fokus keyboard ke jendela yang dilampirkan ke antrean pesan utas lain.

Contoh

Misalnya, lihat Menginisialisasi Kotak Dialog.

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 winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-window-l1-1-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

Fungsi AttachThreadInput, fungsi GetFocus, WM_KILLFOCUS, WM_SETFOCUS, WM_SYSCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP, Input Keyboard