Antarmuka IShellFolder (shobjidl_core.h)

Diekspos oleh semua objek folder namespace Shell, metodenya digunakan untuk mengelola folder.

Warisan

Antarmuka IShellFolder mewarisi dari antarmuka IUnknown . IShellFolder juga memiliki jenis anggota ini:

Metode

Antarmuka IShellFolder memiliki metode ini.

IShellFolder::BindToObject Mengambil handler, biasanya objek folder Shell yang mengimplementasikan IShellFolder untuk item tertentu. Parameter opsional yang mengontrol konstruksi handler diteruskan dalam konteks ikatan.
IShellFolder::BindToStorage Meminta penunjuk ke antarmuka penyimpanan objek.
IShellFolder::CompareIDs Menentukan urutan relatif dari dua objek atau folder file, mengingat daftar pengidentifikasi itemnya.
IShellFolder::CreateViewObject Meminta objek yang dapat digunakan untuk mendapatkan informasi dari atau berinteraksi dengan objek folder.
IShellFolder::EnumObjects Memungkinkan klien menentukan konten folder dengan membuat objek enumerasi pengidentifikasi item dan mengembalikan antarmuka IEnumIDList-nya. Metode yang didukung oleh antarmuka tersebut kemudian dapat digunakan untuk menghitung konten folder.
IShellFolder::GetAttributesOf Mendapatkan atribut dari satu atau beberapa objek file atau folder yang terkandung dalam objek yang diwakili oleh IShellFolder.
IShellFolder::GetDisplayNameOf Mengambil nama tampilan untuk objek file atau subfolder yang ditentukan.
IShellFolder::GetUIObjectOf Mendapatkan objek yang dapat digunakan untuk melakukan tindakan pada objek atau folder file yang ditentukan.
IShellFolder::P arseDisplayName Menerjemahkan nama tampilan objek file atau folder ke dalam daftar pengidentifikasi item.
IShellFolder::SetNameOf Mengatur nama tampilan objek file atau subfolder, mengubah pengidentifikasi item dalam proses.

Keterangan

Terapkan antarmuka ini untuk objek yang memperluas namespace Shell. Misalnya, terapkan antarmuka ini untuk membuat namespace terpisah yang memerlukan Windows Explorer berakar atau menginstal namespace baru langsung dalam hierarki namespace sistem. Anda paling terbiasa dengan konten namespace Anda, sehingga Anda bertanggung jawab untuk menerapkan semua yang diperlukan untuk mengakses data Anda.

Gunakan antarmuka ini saat Anda perlu menampilkan atau melakukan operasi pada konten namespace Shell. Objek yang mendukung IShellFolder biasanya dibuat oleh objek folder Shell lainnya. Untuk mengambil antarmuka IShellFolder folder, Anda biasanya mulai dengan memanggil SHGetDesktopFolder. Fungsi ini mengembalikan penunjuk ke antarmuka IShellFolder desktop. Anda kemudian dapat menggunakan metodenya untuk mengambil antarmuka IShellFolder untuk folder namespace tertentu.

Perhatikan metode IShellFolder hanya menerima PIDL yang relatif terhadap folder. Beberapa metode IShellFolder , seperti IShellFolder::GetAttributesOf, hanya menerima PIDL tingkat tunggal. Dengan kata lain, PIDL hanya boleh berisi satu struktur SHITEMID , ditambah NULL yang mengakhiri. Ketika Anda menghitung konten folder dengan IEnumIDList, Anda akan menerima PIDL formulir ini. Metode lain, seperti IShellFolder::CompareIDs, menerima PIDL multi-level. PIDL ini dapat memiliki beberapa struktur SHITEMID dan mengidentifikasi objek satu atau beberapa tingkat di bawah folder induk. Periksa referensi untuk memastikan jenis PIDL apa yang dapat diterima dengan metode tertentu.

 

Contoh

Contoh implementasi IShellFolder dapat dilihat dalam sampel Sampel Penyedia Data Explorer . Penggunaan berbagai metode IShellFolder dapat ditemukan dalam beberapa sampel, termasuk Sampel Operasi File.

Persyaratan

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