Antarmuka IThumbnailProvider (thumbcache.h)

Mengekspos metode untuk mendapatkan gambar mini dan dimaksudkan untuk diimplementasikan untuk penangan gambar mini. Objek yang mengimplementasikan antarmuka ini juga harus menerapkan 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.

Komentar

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}} ;

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

Dimungkinkan agar implementasi thumbnail 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::Inisialisasi dengan jalur file.

Jika tidak ada antarmuka ini, IThumbnailProvider tidak dipanggil.

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

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

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	thumbcache.h