Metode IShellBrowser::BrowseObject (shobjidl_core.h)
Menginformasikan Windows Explorer untuk menelusuri ke folder lain.
Sintaks
HRESULT BrowseObject(
PCUIDLIST_RELATIVE pidl,
UINT wFlags
);
Parameter
pidl
Jenis: PCUIDLIST_RELATIVE
Alamat struktur ITEMIDLIST (daftar pengidentifikasi item) yang menentukan lokasi objek. Nilai ini tergantung pada bendera atau bendera yang diatur dalam parameter wFlags .
wFlags
Jenis: UINT
Bendera yang menentukan folder yang akan dijelajahi. Nilainya bisa nol atau satu atau beberapa nilai berikut.
Bendera ini menentukan apakah jendela lain akan dibuat.
SBSP_DEFBROWSER (0x0000)
Gunakan perilaku default, yang menghormati opsi tampilan (pengaturan pengguna untuk membuat jendela baru atau untuk menelusuri di tempat). Dalam kebanyakan kasus, aplikasi panggilan harus menggunakan bendera ini.
SBSP_SAMEBROWSER
Telusuri ke folder lain dengan jendela Windows Explorer yang sama.
SBSP_NEWBROWSER
Membuat jendela lain untuk folder yang ditentukan.
Bendera berikut menentukan mode . Nilai-nilai ini diabaikan jika SBSP_SAMEBROWSER ditentukan atau jika SBSP_DEFBROWSER ditentukan dan pengguna telah memilih Telusuri Di Tempat.
SBSP_DEFMODE
Gunakan jendela saat ini.
SBSP_OPENMODE
Menentukan tidak ada pohon folder untuk jendela telusuri baru. Jika browser saat ini tidak cocok dengan SBSP_OPENMODE panggilan objek telusuri, jendela baru dibuka.
SBSP_EXPLOREMODE
Menentukan pohon folder untuk jendela telusuri baru. Jika browser saat ini tidak cocok dengan SBSP_EXPLOREMODE panggilan objek telusuri, jendela baru akan dibuka.
SBSP_HELPMODE
Tidak didukung. Jangan gunakan.
SBSP_NOTRANSFERHIST
Jangan transfer riwayat penjelajahan ke jendela baru.
Bendera berikut menentukan kategori parameter pidl .
SBSP_ABSOLUTE
PIDL absolut, relatif terhadap desktop.
SBSP_RELATIVE
PIDL relatif, relatif terhadap folder saat ini.
SBSP_PARENT
Telusuri folder induk, abaikan PIDL.
SBSP_NAVIGATEBACK
Navigasi kembali, abaikan PIDL.
SBSP_NAVIGATEFORWARD
Navigasi ke depan, abaikan PIDL.
SBSP_ALLOW_AUTONAVIGATE (0x00010000)
Aktifkan navigasi otomatis.
Bendera berikut menentukan mode.
SBSP_KEEPSAMETEMPLATE (0x00020000)
Windows Vista dan yang lebih baru. Tidak didukung. Jangan gunakan.
SBSP_KEEPWORDWHEELTEXT (0x00040000)
Windows Vista dan yang lebih baru. Navigasi tanpa menghapus bidang entri pencarian.
SBSP_ACTIVATE_NOFOCUS (0x00080000)
Windows Vista dan yang lebih baru. Navigasi tanpa perilaku default pengaturan fokus ke tampilan baru.
Bendera berikut mengontrol bagaimana riwayat dimanipulasi sebagai hasil navigasi.
SBSP_CALLERUNTRUSTED (0x00800000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) dan yang lebih baru. Navigasi mungkin dimulai oleh halaman web dengan kode skrip yang sudah ada di sistem lokal.
SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) dan yang lebih baru. Jendela baru adalah hasil dari tindakan yang dimulai pengguna. Percayai jendela baru jika segera mencoba mengunduh isi.
SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) dan yang lebih baru. Jendela menavigasi ke file non-HTML yang tidak tepercaya. Jika pengguna mencoba mengunduh file, jangan izinkan pengunduhan.
SBSP_NOAUTOSELECT
Sembunyikan pilihan di panel riwayat.
SBSP_WRITENOHISTORY
Tidak menulis riwayat navigasi ini di folder Shell riwayat.
SBSP_CREATENOHISTORY (0x00100000)
0x00100000. Windows 7 dan yang lebih baru. Jangan tambahkan entri baru ke log perjalanan. Saat pengguna memasukkan istilah pencarian di kotak pencarian dan kemudian menyempurnakan kueri, browser menavigasi ke depan tetapi tidak menambahkan entri log perjalanan tambahan.
SBSP_TRUSTEDFORACTIVEX (0x10000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) dan yang lebih baru. Navigasi harus mengizinkan perintah ActiveX.
SBSP_FEEDNAVIGATION (0x20000000)
Windows Internet Explorer 7 dan yang lebih baru. Jika diizinkan oleh pengaturan registri saat ini, beri browser tujuan untuk dinavigasi.
SBSP_REDIRECT (0x40000000)
Mengaktifkan pengalihan ke URL lain.
SBSP_INITIATEDBYHLINKFRAME (0x80000000)
SBSP_PLAYNOSOUND (0x00200000)
Windows 7 dan yang lebih baru. Jangan membuat navigasi melengkapi suara untuk setiap penekanan tombol di kotak pencarian.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Tampilan dapat menggunakan metode ini untuk memaksa Windows Explorer menelusuri ke tempat tertentu di namespace. Biasanya, ini adalah folder yang terkandung dalam tampilan.
Contoh
IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));
if (SUCCEEDED(hr))
{
hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
psb->Release();
}
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |
| DLL | Shell32.dll (versi 4.0 atau yang lebih baru) |