Fungsi TaskDialogIndirect (commctrl.h)

Artikel
02/24/2024

Fungsi TaskDialogIndirect membuat, menampilkan, dan mengoperasikan dialog tugas. Dialog tugas berisi ikon, pesan, judul, kotak centang verifikasi yang ditentukan aplikasi, tautan perintah, tombol dorong, dan tombol radio. Fungsi ini dapat mendaftarkan fungsi panggilan balik untuk menerima pesan pemberitahuan.

Sintaks

HRESULT TaskDialogIndirect(
  [in]            const TASKDIALOGCONFIG *pTaskConfig,
  [out, optional] int                    *pnButton,
  [out, optional] int                    *pnRadioButton,
  [out, optional] BOOL                   *pfVerificationFlagChecked
);

Parameter

[in] pTaskConfig

Jenis: const TASKDIALOGCONFIG*

Penunjuk ke struktur TASKDIALOGCONFIG yang berisi informasi yang digunakan untuk menampilkan dialog tugas.

[out, optional] pnButton

Jenis: int*

Alamat variabel yang menerima:

salah satu ID tombol yang ditentukan dalam anggota pButtons dari parameter pTaskConfig
salah satu nilai berikut:

Nilai	Deskripsi
0	Panggilan fungsi gagal. Lihat mengembalikan nilai untuk informasi selengkapnya.
IDCANCEL	Tombol Batal dipilih, Alt-F4 ditekan, Escape ditekan atau pengguna mengklik tombol tutup jendela .
IDNO	Tidak ada tombol yang dipilih.
IDOK	Tombol OK dipilih.
IDRETRY	Tombol coba lagi dipilih.
IDYES	Tombol Ya dipilih.

Jika parameter ini NULL, tidak ada nilai yang dikembalikan.

[out, optional] pnRadioButton

Jenis: int*

Alamat variabel yang menerima salah satu ID tombol yang ditentukan dalam anggota pRadioButtons dari parameter pTaskConfig . Jika parameter ini NULL, tidak ada nilai yang dikembalikan.

[out, optional] pfVerificationFlagChecked

Jenis: BOOL*

Alamat variabel yang menerima salah satu nilai berikut.

Nilai	Deskripsi
TRUE	Kotak centang verifikasi dicentang saat dialog dihentikan.
FALSE	Kotak centang verifikasi tidak dicentang saat dialog diberhentikan.

Jika parameter ini NULL, kotak centang verifikasi dinonaktifkan.

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_OUTOFMEMORY	Memori tidak cukup untuk menyelesaikan operasi.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_FAIL	Operasi gagal.

Keterangan

Saat Anda menggunakan kotak dialog tugas untuk menunjukkan bahwa sistem kehabisan memori, string yang ditunjukkan oleh berbagai string dan anggota ikon dalam struktur TASKDIALOGCONFIG tidak boleh diambil dari file sumber daya karena upaya untuk memuat sumber daya mungkin gagal.

Jika Anda membuat dialog tugas saat kotak dialog ada, gunakan handel ke kotak dialog sebagai parameter hWndParent . Parameter hWndParent tidak boleh mengidentifikasi jendela anak, seperti kontrol dalam kotak dialog.

Jendela induk tidak boleh disembunyikan atau dinonaktifkan ketika fungsi ini dipanggil.


int nButtonPressed                  = 0;
TASKDIALOGCONFIG config             = {0};
const TASKDIALOG_BUTTON buttons[]   = { 
                                        { IDOK, L"Change password" }
                                      };
config.cbSize                       = sizeof(config);
config.hInstance                    = hInst;
config.dwCommonButtons              = TDCBF_CANCEL_BUTTON;
config.pszMainIcon                  = TD_WARNING_ICON;
config.pszMainInstruction           = L"Change Password";
config.pszContent                   = L"Remember your changed password.";
config.pButtons                     = buttons;
config.cButtons                     = ARRAYSIZE(buttons);

TaskDialogIndirect(&config, &nButtonPressed, NULL, NULL);
switch (nButtonPressed)
{
    case IDOK:
        break; // the user pressed button 0 (change password).
    case IDCANCEL:
        break; // user canceled the dialog
    default:
        break; // should never happen
}

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 (termasuk Commctrl.h)
Pustaka	Comctl32.lib
DLL	Comctl32.dll (versi 6)

Lihat juga

Kotak Dialog

Bagikan melalui