Struktur BROWSEINFOA (shlobj_core.h)
Berisi parameter untuk fungsi SHBrowseForFolder dan menerima informasi tentang folder yang dipilih oleh pengguna.
Sintaks
typedef struct _browseinfoA {
HWND hwndOwner;
PCIDLIST_ABSOLUTE pidlRoot;
LPSTR pszDisplayName;
LPCSTR lpszTitle;
UINT ulFlags;
BFFCALLBACK lpfn;
LPARAM lParam;
int iImage;
} BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
Anggota
hwndOwner
Jenis: HWND
Handel ke jendela pemilik untuk kotak dialog.
pidlRoot
Jenis: PCIDLIST_ABSOLUTE
PIDL yang menentukan lokasi folder akar tempat mulai menjelajah. Hanya folder yang ditentukan dan subfoldernya dalam hierarki namespace muncul dalam kotak dialog. Anggota ini bisa NULL; dalam hal ini, lokasi default digunakan.
pszDisplayName
Jenis: LPTSTR
Arahkan ke buffer untuk menerima nama tampilan folder yang dipilih oleh pengguna. Ukuran buffer ini diasumsikan MAX_PATH karakter.
lpszTitle
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null yang ditampilkan di atas kontrol tampilan pohon dalam kotak dialog. String ini dapat digunakan untuk menentukan instruksi kepada pengguna.
ulFlags
Jenis: UINT
Bendera yang menentukan opsi untuk kotak dialog. Anggota ini bisa 0 atau kombinasi dari nilai berikut. Nomor versi mengacu pada versi minimum Shell32.dll yang diperlukan untuk SHBrowseForFolder untuk mengenali bendera yang ditambahkan dalam rilis selanjutnya. Lihat Versi Shell dan Kontrol Umum untuk informasi selengkapnya.
BIF_RETURNONLYFSDIRS (0x00000001)
0x00000001. Hanya mengembalikan direktori sistem file. Jika pengguna memilih folder yang bukan bagian dari sistem file, tombol OK berwarna abu-abu.
BIF_DONTGOBELOWDOMAIN (0x00000002)
0x00000002. Jangan sertakan folder jaringan di bawah tingkat domain dalam kontrol tampilan pohon kotak dialog.
BIF_STATUSTEXT (0x00000004)
0x00000004. Sertakan area status dalam kotak dialog. Fungsi panggilan balik dapat mengatur teks status dengan mengirim pesan ke kotak dialog. Bendera ini tidak didukung ketika BIF_NEWDIALOGSTYLE ditentukan.
BIF_RETURNFSANCESTORS (0x00000008)
0x00000008. Hanya mengembalikan leluhur sistem file. Leluhur adalah subfolder yang berada di bawah folder akar dalam hierarki namespace. Jika pengguna memilih leluhur folder akar yang bukan bagian dari sistem file, tombol OK berwarna abu-abu.
BIF_EDITBOX (0x00000010)
0x00000010. Versi 4.71. Sertakan kontrol edit dalam kotak dialog telusuri yang memungkinkan pengguna mengetikkan nama item.
BIF_VALIDATE (0x00000020)
0x00000020. Versi 4.71. Jika pengguna mengetikkan nama yang tidak valid ke dalam kotak edit, kotak dialog telusuri memanggil BrowseCallbackProc aplikasi dengan pesan BFFM_VALIDATEFAILED . Bendera ini diabaikan jika BIF_EDITBOX tidak ditentukan.
BIF_NEWDIALOGSTYLE (0x00000040)
0x00000040. Versi 5.0. Gunakan antarmuka pengguna baru. Mengatur bendera ini memberi pengguna kotak dialog yang lebih besar yang dapat diubah ukurannya. Kotak dialog memiliki beberapa kemampuan baru, termasuk: kemampuan seret dan letakkan dalam kotak dialog, susun ulang, menu pintasan, folder baru, hapus, dan perintah menu pintasan lainnya.
BIF_BROWSEINCLUDEURLS (0x00000080)
0x00000080. Versi 5.0. Kotak dialog telusuri dapat menampilkan URL. Bendera BIF_USENEWUI dan BIF_BROWSEINCLUDEFILES juga harus diatur. Jika salah satu dari ketiga bendera ini tidak diatur, kotak dialog browser menolak URL. Bahkan ketika bendera ini diatur, kotak dialog telusuri menampilkan URL hanya jika folder yang berisi item yang dipilih mendukung URL. Ketika metode IShellFolder::GetAttributesOf folder dipanggil untuk meminta atribut item yang dipilih, folder harus mengatur bendera atribut SFGAO_FOLDER . Jika tidak, kotak dialog telusuri tidak akan menampilkan URL.
BIF_USENEWUI
Versi 5.0. Gunakan antarmuka pengguna baru, termasuk kotak edit. Bendera ini setara dengan BIF_EDITBOX | BIF_NEWDIALOGSTYLE.
BIF_UAHINT (0x00000100)
0x00000100. Versi 6.0. Saat dikombinasikan dengan BIF_NEWDIALOGSTYLE, menambahkan petunjuk penggunaan ke kotak dialog, sebagai pengganti kotak edit. BIF_EDITBOX mengambil alih bendera ini.
BIF_NONEWFOLDERBUTTON (0x00000200)
0x00000200. Versi 6.0. Jangan sertakan tombol Folder Baru dalam kotak dialog telusuri.
BIF_NOTRANSLATETARGETS (0x00000400)
0x00000400. Versi 6.0. Ketika item yang dipilih adalah pintasan, kembalikan PIDL pintasan itu sendiri daripada targetnya.
BIF_BROWSEFORCOMPUTER (0x00001000)
0x00001000. Hanya mengembalikan komputer. Jika pengguna memilih apa pun selain komputer, tombol OK berwarna abu-abu.
BIF_BROWSEFORPRINTER (0x00002000)
0x00002000. Hanya izinkan pemilihan pencetak. Jika pengguna memilih apa pun selain printer, tombol OK berwarna abu-abu.
Di Windows XP dan sistem yang lebih baru, praktik terbaiknya adalah menggunakan dialog gaya Windows XP, mengatur akar dialog ke folder Printer dan Faks (CSIDL_PRINTERS).
BIF_BROWSEINCLUDEFILES (0x00004000)
0x00004000. Versi 4.71. Kotak dialog telusuri menampilkan file serta folder.
BIF_SHAREABLE (0x00008000)
0x00008000. Versi 5.0. Kotak dialog telusuri dapat menampilkan sumber daya yang dapat dibagikan pada sistem jarak jauh. Ini ditujukan untuk aplikasi yang ingin mengekspos berbagi jarak jauh pada sistem lokal. Bendera BIF_NEWDIALOGSTYLE juga harus diatur.
BIF_BROWSEFILEJUNCTIONS (0x00010000)
0x00010000. Windows 7 dan yang lebih baru. Perbolehkan persimpangan folder seperti pustaka atau file terkompresi dengan ekstensi nama file .zip untuk dijelajahi.
lpfn
Jenis: BFFCALLBACK
Penunjuk ke fungsi yang ditentukan aplikasi yang dipanggil kotak dialog saat peristiwa terjadi. Untuk informasi selengkapnya, lihat fungsi BrowseCallbackProc . Anggota ini bisa NULL.
lParam
Jenis: LPARAM
Nilai yang ditentukan aplikasi yang diteruskan kotak dialog ke fungsi panggilan balik, jika ditentukan dalam lpfn.
iImage
Jenis: int
Nilai bilangan bulat yang menerima indeks gambar yang terkait dengan folder yang dipilih, disimpan dalam daftar gambar sistem.
Keterangan
Catatan
Header shlobj_core.h mendefinisikan BROWSEINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP, Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | shlobj_core.h (termasuk Shlobj.h, Shlobj_core.h) |