Bagikan melalui

Antarmuka IColumnProvider (shlobj.h)

  • Artikel

Mengekspos metode yang memungkinkan penambahan kolom kustom dalam tampilan Detail Windows Explorer.

Catatan Dukungan untuk IColumnProvider telah dihapus pada Windows Vista. Sistem properti Windows digunakan di tempatnya. Lihat Sistem Properti Windows untuk materi konseptual yang menjelaskan penggunaan sistem baru.
 

Warisan

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

Metode

Antarmuka IColumnProvider memiliki metode ini.

 
IColumnProvider::GetColumnInfo

Meminta informasi tentang kolom.
IColumnProvider::GetItemData

Meminta data kolom untuk file tertentu.
IColumnProvider::Initialize

Menginisialisasi antarmuka IColumnProvider.

Keterangan

Tampilan Detail Windows Explorer biasanya menampilkan beberapa kolom standar. Setiap kolom mencantumkan informasi, seperti ukuran atau jenis file, untuk setiap file di folder saat ini. Mungkin juga ada sejumlah kolom yang dapat dipilih pengguna untuk ditampilkan. Saat pengguna mengklik kanan salah satu header kolom, daftar kolom yang tersedia ditampilkan dalam kotak dialog. Dengan membuat objek penyedia kolom yang mengekspor antarmuka IColumnProvider , Anda bisa menambahkan kolom kustom ke kotak dialog tersebut untuk ditampilkan oleh Windows Explorer. Misalnya, kumpulan file yang berisi musik dapat menggunakan penyedia kolom untuk menampilkan kolom yang mencantumkan artis dan bagian yang dimuat oleh setiap file.

Penyedia kolom adalah objek global yang dipanggil setiap kali Windows Explorer menampilkan tampilan Detail. Windows Explorer meminta semua penyedia kolom terdaftar untuk karakteristik kolom mereka. Jika pengguna telah memilih salah satu kolom penyedia kolom, Windows Explorer meminta penyedia kolom untuk data terkait untuk setiap file di folder. Kemudian menampilkan semua kolom yang dipilih.

Biasanya, penyedia kolom digunakan untuk menampilkan satu atau beberapa kolom kustom untuk jenis file tertentu. Saat penyedia kolom menerima permintaan data, penyedia kolom menyediakannya jika file adalah anggota dari jenis yang didukung. Jika tidak, permintaan akan diabaikan dengan mengembalikan S_FALSE.

Kolom diidentifikasi oleh struktur SHCOLUMNID yang berisi pasangan pid fmtid/. Jika memungkinkan, gunakan fmtids dan pids yang ada. Jika folder berisi file dengan lebih dari satu jenis file, data dari berbagai jenis dapat digabungkan ke dalam kolom yang sama. Misalnya, pid Penulis dari kumpulan properti informasi ringkasan dapat digunakan untuk berbagai tujuan. Jika Anda menggunakan struktur SHCOLUMNID kustom, kolom hanya akan menampilkan data untuk file-file yang merupakan anggota dari jenis yang didukung. Jika folder berisi file lain, entrinya akan kosong.

Terapkan objek yang mengekspor antarmuka ini ketika Anda ingin memiliki satu atau beberapa kolom kustom yang ditampilkan dalam tampilan Detail Windows Explorer. Windows Explorer memanggil metode antarmuka untuk meminta informasi yang diperlukan untuk menampilkan kolom. Prosedur yang digunakan oleh Windows Explorer adalah sebagai berikut:

  1. Panggil IColumnProvider::Initialize untuk menentukan folder yang akan ditampilkan.
  2. Panggil IColumnProvider::GetColumnInfo untuk mengambil karakteristik kolom.
  3. Jika kolom telah dipilih oleh pengguna, panggil IColumnProvider::GetItemData untuk setiap file di folder untuk mengambil data yang termasuk dalam entri kolom file.
Selain pendaftaran Model Objek Komponen (COM) normal, objek penyedia kolom juga harus didaftarkan ke Windows Explorer. Untuk melakukannya, tambahkan subkunjuk bernama dengan bentuk string GUID objek ke kunci ini. 
HKEY_CLASSES_ROOT
   Folder
      shellex
         ColumnHandlers

Antarmuka ini dipanggil oleh Windows Explorer. Biasanya tidak digunakan oleh aplikasi.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header shlobj.h