Bagikan melalui

Metode IShellBrowser::BrowseObject (shobjidl_core.h)

  • Artikel

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)

Lihat juga

IShellBrowser