WM_INITDIALOG pesan

  • Artikel

Dikirim ke prosedur kotak dialog segera sebelum kotak dialog ditampilkan. Prosedur kotak dialog biasanya menggunakan pesan ini untuk menginisialisasi kontrol dan melakukan tugas inisialisasi lain yang memengaruhi tampilan kotak dialog.

#define WM_INITDIALOG                   0x0110

Parameter

wParam

Handel ke kontrol untuk menerima fokus keyboard default. Sistem menetapkan fokus keyboard default hanya jika prosedur kotak dialog mengembalikan TRUE.

lParam

Data inisialisasi tambahan. Data ini diteruskan ke sistem sebagai parameter lParam dalam panggilan ke fungsi CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, atau DialogBoxParam yang digunakan untuk membuat kotak dialog. Untuk lembar properti, parameter ini adalah penunjuk ke struktur PROPSHEETPAGE yang digunakan untuk membuat halaman. Parameter ini nol jika fungsi pembuatan kotak dialog lainnya digunakan.

Menampilkan nilai

Prosedur kotak dialog harus mengembalikan TRUE untuk mengarahkan sistem untuk mengatur fokus keyboard ke kontrol yang ditentukan oleh wParam. Jika tidak, ini harus mengembalikan FALSE untuk mencegah sistem mengatur fokus keyboard default.

Prosedur kotak dialog harus mengembalikan nilai secara langsung. Nilai DWL_MSGRESULT yang ditetapkan oleh fungsi SetWindowLong diabaikan.

Keterangan

Kontrol untuk menerima fokus keyboard default selalu merupakan kontrol pertama dalam kotak dialog yang terlihat, tidak dinonaktifkan, dan yang memiliki gaya WS_TABSTOP . Saat prosedur kotak dialog mengembalikan TRUE, sistem memeriksa kontrol untuk memastikan bahwa prosedur belum menonaktifkannya. Jika telah dinonaktifkan, sistem mengatur fokus keyboard ke kontrol berikutnya yang terlihat, tidak dinonaktifkan, dan memiliki WS_TABSTOP.

Aplikasi dapat mengembalikan FALSE hanya jika telah mengatur fokus keyboard ke salah satu kontrol 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]
Header
Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Konseptual

Kotak Dialog

Sumber Daya Lainnya

PROPSHEETPAGE