Antarmuka IShellIconOverlay (shlobj_core.h)

Mengekspos metode yang digunakan oleh ekstensi namespace layanan untuk menentukan overlay ikon untuk objek yang dikandungnya.

Warisan

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

Metode

Antarmuka IShellIconOverlay memiliki metode ini.

IShellIconOverlay::GetOverlayIconIndex Mendapatkan indeks overlay ikon dalam daftar gambar sistem.
IShellIconOverlay::GetOverlayIndex Mendapatkan indeks overlay dalam daftar gambar sistem.

Keterangan

Overlay ikon adalah gambar kecil yang ditempatkan di sudut kiri bawah ikon yang mewakili objek Shell. Mereka biasanya digunakan untuk menambahkan beberapa informasi tambahan ke ikon. Overlay ikon yang umum digunakan adalah panah kecil yang menunjukkan bahwa ikon file atau folder mewakili pintasan.

Overlay ikon adalah bagian dari daftar gambar sistem. Mereka memiliki dua pengidentifikasi. Salah satunya adalah indeks overlay berbasis satu yang mengidentifikasi overlay relatif terhadap overlay lain dalam daftar gambar. Yang lainnya adalah indeks gambar yang mengidentifikasi gambar aktual. Kedua indeks ini setara dengan nilai yang Anda tetapkan ke parameter iOverlay dan iImage , masing-masing, saat Anda menambahkan overlay ikon ke daftar gambar privat dengan ImageList::SetOverlayImage.

Sebelum menampilkan ikon untuk objek, Shell memanggil antarmuka IShellIconOverlay folder terkait untuk mengkueri apakah ikon objek harus memiliki overlay. Biasanya memanggil IShellIconOverlay::GetOverlayIndex untuk meminta indeks overlay overlay. Dalam beberapa kasus, Shell mungkin memanggil IShellIconOverlay::GetOverlayIconIndex untuk meminta indeks gambar overlay. Untuk menentukan overlay ikon, metode harus mengembalikan indeks yang diminta. Jika tidak, mereka kembali S_FALSE.

Untuk menentukan overlay ikon, kedua metode harus terlebih dahulu mengambil indeks overlay overlay dalam daftar gambar sistem dengan memanggil SHGetIconOverlayIndex. Ketika SHGetIconOverlayIndex dipanggil untuk pertama kalinya, Shell menggunakan nama file dan indeks overlay dalam file untuk menambahkan gambar ke daftar gambar sistem. Setelah overlay berada dalam daftar gambar sistem, Shell hanya menggunakan nama file dan indeks sebagai pengidentifikasi. Anda juga dapat menggunakan SHGetIconOverlayIndex untuk mengambil indeks overlay dari beberapa overlay sistem standar. IShellIconOverlay::GetOverlayIndex hanya mengembalikan indeks overlay ke Shell. IShellIconOverlay::GetOverlayIconIndex harus menggunakan makro INDEXTOOVERLAYMASK untuk mengonversi indeks overlay ke indeks gambar yang setara.

Jumlah penangan overlay ikon yang berbeda yang dapat didukung sistem dibatasi oleh jumlah ruang yang tersedia untuk overlay ikon dalam daftar gambar sistem. Saat ini ada lima belas slot yang dialokasikan untuk overlay ikon, beberapa di antaranya dicadangkan oleh sistem. Untuk alasan ini, overlay ikon harus ditentukan hanya jika tidak ada alternatif yang memuaskan.

Antarmuka ini diimplementasikan oleh ekstensi namespace yang perlu menentukan overlay ikon untuk objeknya.

Antarmuka ini biasanya tidak digunakan oleh aplikasi.

Persyaratan

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