Bagikan melalui


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.

Catatan Tombol OK tetap diaktifkan untuk item "\\server", serta item "\\server\share" dan direktori. Namun, jika pengguna memilih item "\\server", meneruskan PIDL yang dikembalikan oleh SHBrowseForFolder ke SHGetPathFromIDList gagal.
 

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.

Catatan Jika COM diinisialisasi melalui CoInitializeEx dengan set bendera COINIT_MULTITHREADED, SHBrowseForFolder gagal jika BIF_NEWDIALOGSTYLE diteruskan.
 

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.

Catatan Jika COM diinisialisasi melalui CoInitializeEx dengan set bendera COINIT_MULTITHREADED, SHBrowseForFolder gagal jika BIF_USENEWUI diteruskan.
 

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)