Antarmuka IThumbnailProvider (thumbcache.h)

  • Artikel

Mengekspos metode untuk mendapatkan gambar mini dan dimaksudkan untuk diimplementasikan untuk penangan gambar mini. Objek yang mengimplementasikan antarmuka ini juga harus mengimplementasikan IInitializeWithStream.

Warisan

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

Metode

Antarmuka IThumbnailProvider memiliki metode ini.

 
IThumbnailProvider::GetThumbnail

Mendapatkan gambar mini dan jenis alfa.

Keterangan

Shell memanggil IThumbnailProvider::GetThumbnail untuk mendapatkan gambar yang akan digunakan sebagai representasi item.

Implementasi antarmuka ini untuk gambar mini foto disediakan di Microsoft Windows sebagai CLSID_PhotoThumbnailProvider. Aplikasi yang menggunakan implementasi yang disediakan harus menentukan pengidentifikasi CLSID konstan menggunakan GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}.

// {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}
const CLSID CLSID_PhotoThumbnailProvider = {0xC7657C4A, 0x9F68, 0x40fa, {0xA4, 0xDF, 0x96, 0xBC, 0x08, 0xEB, 0x35, 0x51}} ;

Initializing Objek yang mengimplementasikan antarmuka ini juga harus mengimplementasikan IInitializeWithStream. Shell memanggil IInitializeWithStream::Initialize dengan aliran item, dan IInitializeWithStream adalah satu-satunya antarmuka inisialisasi yang digunakan ketika instans IThumbnailProvider dimuat out-of-proc (untuk tujuan isolasi). Ini adalah jalur kode utama untuk Windows untuk semua jalur kode IThumbnailCache.

Dimungkinkan bagi implementasi thumbnail untuk diinisialisasi dengan IInitializeWithItem atau IInitializeWithFile ketika handler diminta oleh pihak ke-3 tanpa menggunakan IThumbnailCache API, tetapi ini jarang terjadi. Jika Anda menerapkan IInitializeWithItem, Shell memanggil IInitializeWithItem::Initialize dengan representasi IShellItem item. Jika Anda menerapkan IInitializeWithFile, Shell memanggil IInitializeWithFile::Initialize dengan jalur file.

Jika tidak ada antarmuka ini, IThumbnailProvider tidak dipanggil.

Aplikasi klien Jika Anda mengembangkan aplikasi klien, Anda harus menggunakan IShellItemImageFactory sebagai gantinya.

Windows Vista IThumbnailProivder baru untuk Vista dan menggantikan IExtractImage. Vista masih mendukung IExtractImage tetapi tidak memiliki kemampuan untuk mengembalikan jenis gambar (alfa atau tidak).

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 thumbcache.h