Fungsi panggilan balik PFTASKDIALOGCALLBACK (commctrl.h)

2023-08-22

Fungsi TaskDialogCallbackProc adalah fungsi yang ditentukan aplikasi yang digunakan dengan fungsi TaskDialogIndirect . Ini menerima pesan dari dialog tugas ketika berbagai peristiwa terjadi.

Jenis PFTASKDIALOGCALLBACK mendefinisikan penunjuk ke fungsi panggilan balik ini. TaskDialogCallbackProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

Parameter

[in] hwnd

Jenis: HWND

Tangani ke jendela TaskDialog. Jangan terus mengirim pesan ke hwnd setelah prosedur panggilan balik kembali dari dipanggil dengan TDN_DESTROYED.

[in] msg

Jenis: UINT

Salah satu pemberitahuan berikut.

Pemberitahuan	Penggunaan
TDN_BUTTON_CLICKED	Menunjukkan bahwa tombol telah dipilih. ID perintah tombol ditentukan oleh wParam.
TDN_CREATED	Menunjukkan bahwa Dialog Tugas telah dibuat.
TDN_DESTROYED	Menunjukkan bahwa Dialog Tugas telah dihancurkan.
TDN_DIALOG_CONSTRUCTED	Menunjukkan bahwa Dialog Tugas telah dibuat tetapi belum ditampilkan.
TDN_EXPANDO_BUTTON_CLICKED	Menunjukkan bahwa tombol expando telah dipilih.
TDN_HELP	Menunjukkan bahwa tombol F1 telah ditekan saat Dialog Tugas memiliki fokus.
TDN_HYPERLINK_CLICKED	Menunjukkan bahwa hyperlink telah dipilih. Penunjuk ke teks tautan ditentukan oleh lParam.
TDN_NAVIGATED	Menunjukkan bahwa navigasi telah terjadi.
TDN_RADIO_BUTTON_CLICKED	Menunjukkan bahwa tombol radio telah dipilih. ID perintah tombol radio ditentukan oleh wParam.
TDN_TIMER	Menunjukkan bahwa timer Dialog Tugas telah diaktifkan. Total waktu yang berlalu ditentukan oleh wParam. Anda dapat memperbarui bilah kemajuan dengan mengirim pesan TDM_SET_PROGRESS_BAR_POS ke jendela yang ditentukan oleh parameter hwnd .
TDN_VERIFICATION_CLICKED	Menunjukkan bahwa kotak centang Verifikasi Dialog Tugas telah dipilih.

[in] wParam

Jenis: WPARAM

Menentukan informasi pemberitahuan tambahan. Konten parameter ini bergantung pada nilai parameter uNotification .

[in] lParam

Jenis: LPARAM

Menentukan informasi pemberitahuan tambahan. Konten parameter ini bergantung pada nilai parameter uNotification .

lpRefData

Jenis: LONG_PTR

Arahkan ke data spesifik aplikasi. Ini adalah data yang ditunjukkan oleh anggota lpCallbackData struktur TASKDIALOGCONFIG yang digunakan untuk membuat dialog tugas.

Mengembalikan nilai

Jenis: HRESULT

Nilai yang dikembalikan khusus untuk pemberitahuan yang sedang diproses. Saat merespons klik tombol, implementasi Anda harus mengembalikan S_FALSE jika Dialog Tugas tidak ditutup. Jika tidak, kembalikan S_OK.

Keterangan

Aplikasi harus mendaftarkan fungsi panggilan balik ini dengan meneruskan alamatnya di anggota pfCallback dari struktur TASKDIALOGCONFIG yang diteruskan melalui pointer melalui TaskDialogIndirect.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h (sertakan Commctrl.h)

Bagikan melalui