Resim Listeleri
Bu bölüm, görüntü listeleriyle kullanılan programlama öğeleri hakkında bilgi içerir.
Genel bakış
| Konu | Içeriği |
|---|---|
| Resim Listeleri | Görüntü listesi, her biri dizini tarafından başvurulabilen aynı boyuttaki görüntülerin koleksiyonudur. |
Işlev
| Konu | Içeriği |
|---|---|
| HIMAGELIST_QueryInterface | Görüntü listesinin HIMAGELIST tanıtıcısına karşılık gelen bir IImageList veya IImageList2 nesnesine bir işaretçi alır. |
| ImageList_Add | Resim listesine resim veya resim ekler. |
| ImageList_AddMasked | Belirtilen bit eşlemden maske oluşturarak bir görüntü listesine resim veya görüntü ekler. |
| ImageList_BeginDrag | Bir görüntüyü sürüklemeye başlar. |
| ImageList_CoCreateInstance | Bir görüntü listesinin tek bir örneğini oluşturur ve buna bir arabirim işaretçisi döndürür. |
| ImageList_Copy | Belirli bir resim listesindeki görüntüleri kopyalar. |
| ImageList_Create | Yeni bir görüntü listesi oluşturur. |
| ImageList_Destroy | Görüntü listesini yok eder. |
| ImageList_DragEnter | Sürükleme görüntüsünü pencere içinde belirtilen konumda görüntüler. |
| ImageList_DragLeave | Belirtilen pencerenin kilidini açar ve sürükleme görüntüsünü gizleyerek pencerenin güncelleştirilebilmesini sağlar. |
| ImageList_DragMove | Sürükle ve bırak işlemi sırasında sürüklenen görüntüyü taşır. Bu işlev genellikle bir WM_MOUSEMOVE iletisine yanıt olarak çağrılır. |
| ImageList_DragShowNolock | Sürüklenen görüntüyü gösterir veya gizler. |
| ImageList_Draw | Belirtilen cihaz bağlamında bir resim listesi öğesi çizer. |
| ImageList_DrawEx | Belirtilen cihaz bağlamında bir resim listesi öğesi çizer. İşlev, belirtilen çizim stilini kullanır ve görüntüyü belirtilen renkle harmanlar. |
| ImageList_DrawIndirect |
IMAGELISTDRAWPARAMS yapısını temel alan bir resim listesi resmi çizer. |
| ImageList_Duplicate | Varolan bir görüntü listesinin kopyasını oluşturur. |
| ImageList_EndDrag | Sürükleme işlemini sonlandırır. |
| ImageList_GetBkColor | Resim listesi için geçerli arka plan rengini alır. |
| ImageList_GetDragImage | Sürükleme görüntüsü için kullanılan geçici görüntü listesini alır. İşlev ayrıca geçerli sürükleme konumunu ve sürükleme görüntüsünün sürükleme konumuna göre uzaklığını da alır. |
| ImageList_GetIcon | Resim listesinde bir resim ve maskeden bir simge oluşturur. |
| ImageList_GetIconSize | Görüntü listesindeki görüntülerin boyutlarını alır. Resim listesindeki tüm görüntüler aynı boyutlara sahiptir. |
| ImageList_GetImageCount | Resim listesindeki görüntü sayısını alır. |
| ImageList_GetImageInfo | Bir görüntü hakkındaki bilgileri alır. |
| ImageList_LoadImage | Belirtilen bit eşlemden bir görüntü listesi oluşturur. |
| ImageList_Merge | Mevcut iki görüntüyü birleştirerek yeni bir görüntü oluşturur. İşlev ayrıca, görüntünün depolandığı yeni bir görüntü listesi de oluşturur. |
| ImageList_Read | Akıştan görüntü listesini okur. |
| ImageList_ReadEx | Bir akıştan görüntü listesini okur ve görüntü listesine bir arabirim döndürür. |
| ImageList_Remove | Resim listesinden bir görüntüyü kaldırır. |
| ImageList_Replace | Resim listesindeki bir görüntüyü yeni bir resimle değiştirir. |
| ImageList_ReplaceIcon | Bir görüntüyü simge veya imleçle değiştirir. |
| ImageList_SetBkColor | Resim listesi için arka plan rengini ayarlar. Bu işlev yalnızca bir simge eklediğinizde veya siyah beyaz bit eşlem ile ImageList_AddMasked kullandığınızda çalışır. Maske olmadan, görüntünün tamamı çizilir; bu nedenle arka plan rengi görünmez. |
| ImageList_SetColorTable | Resim listesi için renk tablosunu ayarlar. |
| ImageList_SetDragCursorImage | Belirtilen görüntüyü (genellikle fare imleci görüntüsü) geçerli sürükleme görüntüsüyle birleştirerek yeni bir sürükleme görüntüsü oluşturur. |
| ImageList_SetIconSize | Resim listesindeki görüntülerin boyutlarını ayarlar ve listedeki tüm görüntüleri kaldırır. |
| ImageList_SetImageCount | Mevcut bir görüntü listesini yeniden boyutlandırıyor. |
| ImageList_SetOverlayImage | Yer paylaşım maskeleri olarak kullanılacak görüntüler listesine belirtilen bir görüntü ekler. Görüntü listesinde sürüm 4.70 ve önceki sürümlerde en fazla dört katman maskesi ve sürüm 4.71'de 15'e kadar yer paylaşım maskesi bulunabilir. İşlev, belirtilen görüntüye bir katman maskesi dizini atar. |
| ImageList_Write | Akışa görüntü listesi yazar. |
| ImageList_WriteEx | Akışa görüntü listesi yazar. |
Makro
| Konu | Içeriği |
|---|---|
| ImageList_AddIcon | Resim listesine simge veya imleç ekler.
ImageList_AddIconImageList_ReplaceIcon işlevini çağırır. |
| ImageList_ExtractIcon |
ImageList_GetIcon işlevini çağırarak bir görüntüye ve resim listesindeki maskeye dayalı bir simge veya imleç oluşturur. |
| ImageList_LoadBitmap | Belirtilen bit eşlem kaynağından görüntü listesi oluşturmak için ImageList_LoadImage işlevini çağırır. |
| ImageList_RemoveAll | Görüntü listesinden tüm görüntüleri kaldırmak için ImageList_Remove işlevini çağırır. |
| indexTOOVERLAYMASK |
ImageList_Draw işlevinin kullanabilmesi için katman maskesinin dizinini hazırlar. |
Arabirim
| Konu | Içeriği |
|---|---|
| IImageList | Görüntü listelerini işleyen ve bunlarla etkileşim kuran yöntemleri kullanıma sunar. IImageListkullanmak için bildirimde Comctl32.dll sürüm 6'yı belirtin. Bunu yapmazsanız, IImageList öngörülemeyen davranışlar görüntüleyebileceği Comctl32.dll sürüm 5 varsayılan olarak kullanılır. Bildirimler hakkında daha fazla bilgi için bkz. Görsel Stilleri Etkinleştirme. |
Yöntemler
| Konu | Içeriği |
|---|---|
| Ekle | Resim listesine resim veya resim ekler. |
| AddMasked | Belirtilen bit eşlemden maske oluşturarak bir görüntü listesine resim veya görüntü ekler. |
| beginDrag | Bir görüntüyü sürüklemeye başlar. |
| Kopyalama | Var olan bir görüntü listesini klonlar. |
| Kopyalama | Belirli bir resim listesinden görüntüleri kopyalar. |
| DragEnter | Bir sürükleme işlemi sırasında güncelleştirmeleri belirtilen pencereye kilitler ve sürükleme görüntüsünü pencerenin içinde belirtilen konumda görüntüler. |
| SürükleKaydet | Belirtilen pencerenin kilidini açar ve sürükleme görüntüsünü gizler ve bu da pencerenin güncelleştirilmesine olanak tanır. |
| DragMove | Sürükle ve bırak işlemi sırasında sürüklenen görüntüyü taşır. Bu işlev genellikle bir WM_MOUSEMOVE iletisine yanıt olarak çağrılır. |
| DragShowNolock | Sürüklenen görüntüyü gösterir veya gizler. |
| çizim | Belirtilen cihaz bağlamında bir resim listesi öğesi çizer. |
| EndDrag | Sürükleme işlemini sonlandırır. |
| GetBkColor | Resim listesi için geçerli arka plan rengini alır. |
| GetDragImage | Sürükleme resmi için kullanılan geçici görüntü listesini alır. İşlev ayrıca geçerli sürükleme konumunu ve sürükleme görüntüsünün sürükleme konumuna göre uzaklığını da alır. |
| GetIcon | Görüntüden bir simge ve resim listesinde bir maske oluşturur. |
| GetIconSize | Resim listesindeki görüntülerin boyutlarını alır. Resim listesindeki tüm görüntüler aynı boyutlara sahiptir. |
| GetImageCount | Resim listesindeki görüntü sayısını alır. |
| GetImageInfo | Bir görüntü hakkında bilgi alır. |
| GetImageRect | Görüntünün sınırlayıcı dikdörtgeni alır. |
| GetItemFlags | Görüntünün bayraklarını alır. |
| GetOverlayImage | Yer paylaşım maskeleri olarak kullanılan görüntüler listesinden belirtilen bir görüntüyü alır. |
| birleştirme | Mevcut iki görüntüyü birleştirerek yeni bir görüntü oluşturur. Bu yöntem, görüntünün depolandığı yeni bir görüntü listesi de oluşturur. |
| Kaldırma | Resim listesinden bir görüntüyü kaldırır. |
| Değiştir | Resim listesindeki bir görüntüyü yeni bir resimle değiştirir. |
| ReplaceIcon | Bir görüntüyü simge veya imleçle değiştirir. |
| SetBkColor | Resim listesi için arka plan rengini ayarlar. Bu yöntem yalnızca görüntü listesine bir simge eklediğinizde veya siyah beyaz bit eşlem eklemek için IImageList::AddMaskedyöntemini kullandığınızda çalışır. Maske olmadan, resmin tamamı çizilir ve arka plan rengi görünmez. |
| SetDragCursorImage | Genellikle fare imleci görüntüsü olan belirtilen görüntüyü geçerli sürükleme görüntüsüyle birleştirerek yeni bir sürükleme görüntüsü oluşturur. |
| SetIconSize | Resim listesindeki görüntülerin boyutlarını ayarlar ve listedeki tüm görüntüleri kaldırır. |
| SetImageCount | Mevcut bir görüntü listesini yeniden boyutlandırıyor. |
| SetOverlayImage | Katman maskeleri olarak kullanılan görüntüler listesine belirtilen bir görüntü ekler. Resim listesinin Ortak Denetimler sürüm 4.70 ve önceki sürümlerinde en fazla 4.71 veya sonraki sürümlerde en fazla 15 katman maskesi olabilir. yöntemi, belirtilen görüntüye bir katman maskesi dizini atar. |
Yapı
| Konu | Içeriği |
|---|---|
| IMAGEINFO | Resim listesindeki bir görüntü hakkında bilgi içerir. Bu yapı, IImageList::GetImageInfo işleviyle kullanılır. |
| IMAGELISTDRAWPARAMS | Görüntü listesi çizim işlemi hakkında bilgi içerir ve IImageList::D raw işleviyle birlikte kullanılır. |