Metode IExplorerBrowser::FillFromObject (shobjidl_core.h)

  • Artikel

Membuat folder hasil dan mengisinya dengan item.

Sintaks

HRESULT FillFromObject(
  [in] IUnknown                    *punk,
  [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags
);

Parameter

[in] punk

Jenis: IUnknown*

Penunjuk antarmuka pada objek sumber yang akan mengisi IResultsFolder. Ini bisa menjadi IDataObject atau objek apa pun yang dapat digunakan dengan INamespaceWalk.

[in] dwFlags

Jenis: EXPLORER_BROWSER_FILL_FLAGS

Salah satu nilai EXPLORER_BROWSER_FILL_FLAGS .

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Objek yang diteruskan melalui punk pointer antarmuka mengisi IResultsFolder.

Parameter dwFlags dapat berupa salah satu EXPLORER_BROWSER_FILL_FLAGS atau bendera apa pun yang ditentukan dalam parameter wFlagsBrowseObject, kecuali untuk bendera yang menunjukkan navigasi.

Parameter punk dapat menjadi objek apa pun yang dapat digunakan INamespaceWalk . Jika dipanggil dengan EBF_SELECTFROMDATAOBJECT, punk harus IDataObject dan namespace akan berjalan di tingkat induk objek data, termasuk semua item serekan, tetapi hanya memilih yang terkandung dalam objek data. Bendera ini paling umum digunakan ketika FOLDERSETTINGS telah FWF_CHECKSELECT diaktifkan, memungkinkan pemilihan pemeriksaan sekumpulan item yang telah dikompilasi dalam objek data.

Catatan Jika penunjuk ke daftar pengidentifikasi item (PIDL) di objek data sepenuhnya memenuhi syarat, folder induk tidak dapat berhasil dijalani, karena item folder desktop akan ditambahkan ke daftar.
 
Metode ini dapat dipanggil lebih dari sekali, dengan setiap panggilan berturut-turut menambahkan item tambahan ke tampilan. IExplorerBrowser::RemoveAll dapat dipanggil untuk menghapus konten folder hasil. Fungsi ini harus dipanggil dengan EBF_NODROPTARGET untuk mencegah pengguna menyeret dropping item baru ke dalam tampilan, kecuali jika ini diinginkan. Pengaturan EBO_NAVIGATEONCE juga disarankan agar browser tetap berada di ResultsFolder, mencegah pengguna menavigasi ke folder yang mungkin diwakili dalam objek data.

Untuk memanipulasi item di folder hasil secara langsung, panggil IExplorerBrowser::GetCurrentView untuk mendapatkan tampilan dari ExplorerBrowser lalu tanyakan tampilan untuk folder hasil menggunakan GetFolder. Menggunakan folder hasil yang diperoleh memungkinkan manipulasi data dalam folder dengan lebih banyak fleksibilitas daripada dengan metode yang disediakan IExplorerBrowser .

Persyaratan

Persyaratan Nilai
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)

Lihat juga

FOLDERFLAGS

IExplorerBrowser