Antarmuka IExtractIconA (shlobj_core.h)

  • Artikel

Mengekspos metode yang memungkinkan klien untuk mengambil ikon yang terkait dengan salah satu objek dalam folder.

Warisan

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

Metode

Antarmuka IExtractIconA memiliki metode ini.

 
IExtracticona::Extract

Mengekstrak gambar ikon dari lokasi yang ditentukan. (ANSI)
IExtractIconA::GetIconLocation

Mendapatkan lokasi dan indeks ikon. (ANSI)

Keterangan

Ada dua cara untuk mengambil ikon objek. Cara paling sederhana adalah memanggil SHGetFileInfo. Namun, pendekatan ini tidak fleksibel dan mungkin lambat. Cara yang lebih fleksibel dan efisien untuk mengambil ikon item adalah dengan menggunakan IExtractIcon. Shell menggunakan IExtractIcon untuk mengambil ikon saat menampilkan konten folder. Untuk menggunakan IExtractIcon untuk mengambil ikon objek, lakukan hal berikut:

  1. Dapatkan penunjuk ke antarmuka IShellFolder folder yang berisi objek .
  2. Panggil IShellFolder::GetUIObjectOf dengan pointer ke daftar pengidentifikasi item (PIDL) objek dan ID antarmuka IExtractIcon (IID_IExtractIcon). Folder membuat objek untuk menangani ekstraksi ikon, dan mengembalikan penunjuk antarmuka IExtractIcon objek.
  3. Panggil IExtractIcon::GetIconLocation untuk mengambil lokasi ikon.
  4. Panggil IExtractIcon::Extract untuk mengambil handel ikon.
Dimungkinkan juga untuk mengekstrak ikon secara asinkron pada utas latar belakang. Pendekatan ini berguna ketika ekstraksi adalah operasi yang memakan waktu. Untuk detailnya, lihat IExtractIcon::GetIconLocation.

Ekstensi namespace mengimplementasikan IExtractIcon untuk menyediakan ikon untuk objeknya. Klien mendapatkan penunjuk antarmuka IExtractIcon untuk objek dalam folder dengan memanggil metode IShellFolder::GetUIObjectOf folder. Implementasi IShellFolder::GetUIObjectOf harus membuat objek untuk menangani ekstraksi ikon dan mengembalikan penunjuk ke antarmuka IExtractIcon objek.

Handler ikon juga mengimplementasikan IExtractIcon. Handler ikon adalah jenis handler ekstensi Shell yang memungkinkan Anda menetapkan ikon secara dinamis kepada anggota jenis file.

Panggil antarmuka ini jika aplikasi Anda membutuhkan cara yang lebih fleksibel untuk mengambil ikon objek daripada SHGetFileInfo.

Catatan

Header shlobj_core.h mendefinisikan IExtractIcon sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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