IFileDialogKustomisasi antarmuka (shobjidl_core.h)

Mengekspos metode yang memungkinkan aplikasi menambahkan kontrol ke dialog file umum.

Warisan

Antarmuka IFileDialogCustomize mewarisi dari antarmuka IUnknown . IFileDialogCustomize juga memiliki jenis anggota ini:

Metode

Antarmuka IFileDialogCustomize memiliki metode ini.

IFileDialogCustomize::AddCheckButton Menambahkan tombol centang (kotak centang) ke dialog.
IFileDialogCustomize::AddComboBox Menambahkan kotak kombo ke dialog.
IFileDialogCustomize::AddControlItem Menambahkan item ke kontrol kontainer dalam dialog.
IFileDialogCustomize::AddEditBox Menambahkan kontrol kotak edit ke dialog.
IFileDialogCustomize::AddMenu Menambahkan menu ke dialog.
IFileDialogCustomize::AddPushButton Menambahkan tombol ke dialog.
IFileDialogCustomize::AddRadioButtonList Menambahkan grup tombol opsi (juga dikenal sebagai tombol radio) ke dialog.
IFileDialogCustomize::AddSeparator Menambahkan pemisah ke dialog, memungkinkan pemisahan kontrol visual.
IFileDialogCustomize::AddText Menambahkan konten teks ke dialog.
IFileDialogCustomize::EnableOpenDropDown Mengaktifkan daftar drop-down pada tombol Buka atau Simpan dalam dialog.
IFileDialogCustomize::EndVisualGroup Menghentikan penambahan elemen ke grup visual dalam dialog.
IFileDialogCustomize::GetCheckButtonState Mendapatkan status tombol centang saat ini (kotak centang) dalam dialog.
IFileDialogCustomize::GetControlItemState Mendapatkan status item saat ini dalam kontrol kontainer yang ditemukan dalam dialog.
IFileDialogCustomize::GetControlState Mendapatkan visibilitas saat ini dan mengaktifkan status kontrol tertentu.
IFileDialogCustomize::GetEditBoxText Mendapatkan teks saat ini dalam kontrol kotak edit.
IFileDialogCustomize::GetSelectedControlItem Mendapatkan item tertentu dari kontrol kontainer tertentu dalam dialog.
IFileDialogCustomize::MakeProminent Menempatkan kontrol dalam dialog sehingga menonjol dibandingkan dengan kontrol lain yang ditambahkan.
IFileDialogCustomize::RemoveAllControlItems Tidak diterapkan. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem Menghapus item dari kontrol kontainer dalam dialog.
IFileDialogCustomize::SetCheckButtonState Mengatur status tombol centang (kotak centang) dalam dialog.
IFileDialogCustomize::SetControlItemState Menyetel status item saat ini dalam kontrol kontainer yang ditemukan dalam dialog.
IFileDialogCustomize::SetControlItemText Mengatur teks item kontrol. Misalnya, teks yang menyertai tombol radio atau item di menu.
IFileDialogCustomize::SetControlLabel Mengatur teks yang terkait dengan kontrol, seperti teks tombol atau label kotak edit.
IFileDialogCustomize::SetControlState Mengatur visibilitas saat ini dan mengaktifkan status kontrol tertentu.
IFileDialogCustomize::SetEditBoxText Mengatur teks dalam kontrol kotak edit yang ditemukan dalam dialog.
IFileDialogCustomize::SetSelectedControlItem Menyetel status item tertentu yang dipilih dalam grup tombol opsi atau kotak kombo yang ditemukan dalam dialog.
IFileDialogCustomize::StartVisualGroup Mendeklarasikan grup visual dalam dialog. Panggilan berikutnya ke metode "tambahkan" menambahkan elemen tersebut ke grup ini.

Keterangan

Kapan Harus Menerapkan

IFileDialogControlEvents diimplementasikan oleh dialog buka file umum (CLSID_FileOpenDialog) dan dialog penyimpanan file (CLSID_FileSaveDialog).

Kontrol ditambahkan ke dialog sebelum dialog ditampilkan. Tata letaknya tersirat oleh urutan penambahannya. Setelah dialog ditampilkan, kontrol tidak dapat ditambahkan atau dihapus, tetapi kontrol yang ada dapat disembunyikan atau dinonaktifkan kapan saja. Label mereka juga dapat diubah kapan saja.

Kontrol kontainer adalah kontrol yang dapat menambahkan item ke dalamnya. Kontrol kontainer mencakup kotak kombo, menu, daftar drop-down yang dilampirkan ke tombol Buka , dan grup tombol opsi apa pun. Urutan item yang muncul dalam kontainer adalah urutan penambahannya. Tidak ada fasilitas untuk menyusun ulang mereka. ID dilingkup ke kontrol induk. Kontrol kontainer, dengan pengecualian menu, memiliki item yang dipilih.

Item dengan kontrol kontainer tidak dapat diubah setelah dibuat, kecuali untuk status diaktifkan dan terlihat. Namun, mereka dapat ditambahkan dan dihapus kapan saja. Misalnya, jika Anda perlu mengubah teks menu, Anda harus menghapus menu saat ini dan menambahkan yang lain dengan teks yang benar.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)