Seznamy obrázků
Tato část obsahuje informace o programovacíchprvch
Přehledy
| Námět | Obsah |
|---|---|
| seznamy obrázků | Seznam obrázků je kolekce obrázků se stejnou velikostí, z nichž každý může být označován indexem. |
Funkce
| Námět | Obsah |
|---|---|
| HIMAGELIST_QueryInterface | Načte ukazatel na objekt IImageList nebo IImageList2 objektu, který odpovídá popisovači HIMAGELIST seznamu obrázků. |
| ImageList_Add | Přidá obrázek nebo obrázky do seznamu obrázků. |
| ImageList_AddMasked | Přidá obrázek nebo obrázky do seznamu obrázků a vygeneruje masku ze zadaného rastrového obrázku. |
| ImageList_BeginDrag | Začne přetahovat obrázek. |
| ImageList_CoCreateInstance | Vytvoří jednu instanci souboru imagelist a vrátí ukazatel rozhraní. |
| ImageList_Copy | Zkopíruje obrázky v rámci daného seznamu obrázků. |
| ImageList_Create | Vytvoří nový seznam imagí. |
| ImageList_Destroy | Zničí seznam obrázků. |
| ImageList_DragEnter | Zobrazí obrázek přetažení na určené pozici v okně. |
| ImageList_DragLeave | Odemkne zadané okno a skryje obrázek přetažení, což umožní aktualizaci okna. |
| ImageList_DragMove | Přesune obrázek, který se přetahuje během operace přetažení. Tato funkce se obvykle volá v reakci na zprávu WM_MOUSEMOVE. |
| ImageList_DragShowNolock | Zobrazí nebo skryje přetahovaný obrázek. |
| ImageList_Draw | Nakreslí položku seznamu obrázků v zadaném kontextu zařízení. |
| ImageList_DrawEx | Nakreslí položku seznamu obrázků v zadaném kontextu zařízení. Funkce používá zadaný styl výkresu a prolnutí obrázku se zadanou barvou. |
| ImageList_DrawIndirect | Nakreslí obrázek seznamu obrázků na základě struktury IMAGELISTDRAWPARAMS. |
| ImageList_Duplicate | Vytvoří duplikát existujícího seznamu imagí. |
| ImageList_EndDrag | Ukončí operaci přetažení. |
| ImageList_GetBkColor | Načte aktuální barvu pozadí seznamu obrázků. |
| ImageList_GetDragImage | Načte dočasný seznam imagí, který se používá pro obrázek přetažení. Funkce také načte aktuální pozici přetažení a posun obrázku přetažení vzhledem k pozici přetažení. |
| ImageList_GetIcon | Vytvoří ikonu z obrázku a masky v seznamu obrázků. |
| ImageList_GetIconSize | Načte rozměry obrázků v seznamu obrázků. Všechny obrázky v seznamu obrázků mají stejné rozměry. |
| ImageList_GetImageCount | Načte počet obrázků v seznamu obrázků. |
| ImageList_GetImageInfo | Načte informace o obrázku. |
| ImageList_LoadImage | Vytvoří seznam obrázků ze zadaného rastrového obrázku. |
| ImageList_Merge | Vytvoří novou image zkombinováním dvou existujících imagí. Funkce také vytvoří nový seznam imagí, do kterého se má obrázek uložit. |
| ImageList_Read | Přečte seznam obrázků ze streamu. |
| ImageList_ReadEx | Načte seznam obrázků ze streamu a vrátí rozhraní do seznamu obrázků. |
| ImageList_Remove | Odebere obrázek ze seznamu obrázků. |
| ImageList_Replace | Nahradí obrázek v seznamu obrázků novým obrázkem. |
| ImageList_ReplaceIcon | Nahradí obrázek ikonou nebo kurzorem. |
| ImageList_SetBkColor | Nastaví barvu pozadí pro seznam obrázků. Tato funkce funguje jenom v případě, že přidáte ikonu nebo použijete ImageList_AddMasked s černobílým rastrovým obrázkem. Bez masky je nakreslen celý obrázek; proto není viditelná barva pozadí. |
| ImageList_SetColorTable | Nastaví barevnou tabulku seznamu obrázků. |
| ImageList_SetDragCursorImage | Vytvoří nový obrázek přetažením zkombinováním zadaného obrázku (obvykle obrázku kurzoru myši) s aktuálním obrázkem přetažení. |
| ImageList_SetIconSize | Nastaví rozměry obrázků v seznamu obrázků a odebere všechny obrázky ze seznamu. |
| ImageList_SetImageCount | Změní velikost existujícího seznamu obrázků. |
| ImageList_SetOverlayImage | Přidá zadaný obrázek do seznamu obrázků, které se mají použít jako překryvné masky. Seznam obrázků může mít až čtyři překryvné masky ve verzi 4.70 a starší a až 15 ve verzi 4.71. Funkce přiřadí k zadanému obrázku index překryvné masky. |
| ImageList_Write | Zapíše seznam obrázků do datového proudu. |
| ImageList_WriteEx | Zapíše seznam obrázků do datového proudu. |
Makra
| Námět | Obsah |
|---|---|
| ImageList_AddIcon | Přidá do seznamu obrázků ikonu nebo kurzor.
ImageList_AddIcon volá funkci ImageList_ReplaceIcon. |
| ImageList_ExtractIcon | Zavolá funkci ImageList_GetIcon, která vytvoří ikonu nebo kurzor na základě obrázku a masky v seznamu obrázků. |
| ImageList_LoadBitmap | Zavolá funkci ImageList_LoadImage k vytvoření seznamu obrázků ze zadaného rastrového prostředku. |
| ImageList_RemoveAll | Zavolá funkci ImageList_Remove, která odebere všechny obrázky ze seznamu obrázků. |
| INDEXTOOVERLAYMASK | Připraví index překryvné masky tak, aby ji funkce ImageList_Draw mohl použít. |
Rozhraní
| Námět | Obsah |
|---|---|
| IImageList | Zveřejňuje metody, které manipulují se seznamy obrázků a pracují s nimi. Chcete-li použít IImageList, zadejte Comctl32.dll verze 6 v manifestu. Pokud to neuděláte, bude Comctl32.dll verze 5 použita ve výchozím nastavení, kdy IImageList může zobrazit nepředvídatelné chování. Další informace o manifestech najdete v tématu Povolení vizuálních stylů. |
Metody
| Námět | Obsah |
|---|---|
| Přidat | Přidá obrázek nebo obrázky do seznamu obrázků. |
| AddMasked | Přidá obrázek nebo obrázky do seznamu obrázků a vygeneruje masku ze zadaného rastrového obrázku. |
| BeginDrag | Začne přetahovat obrázek. |
| Clone | Naklonuje existující seznam imagí. |
| kopírovat | Zkopíruje obrázky z daného seznamu obrázků. |
| dragEnter | Uzamkne aktualizace zadaného okna během operace přetažení a zobrazí obrázek přetažení na určené pozici v okně. |
| DragLeave | Odemkne zadané okno a skryje obrázek přetažení, který umožňuje aktualizaci okna. |
| dragMove | Přesune obrázek, který se přetahuje během operace přetažení. Tato funkce se obvykle volá v reakci na zprávu WM_MOUSEMOVE. |
| DragShowNolock | Zobrazí nebo skryje přetahovaný obrázek. |
| kreslení | Nakreslí položku seznamu obrázků v zadaném kontextu zařízení. |
| EndDrag | Ukončí operaci přetažení. |
| GetBkColor | Získá aktuální barvu pozadí pro seznam obrázků. |
| GetDragImage | Získá dočasný seznam obrázků, který se používá pro přetažení obrázku. Funkce také načte aktuální pozici přetažení a posun obrázku přetažení vzhledem k pozici přetažení. |
| GetIcon | Vytvoří ikonu z obrázku a masku v seznamu obrázků. |
| GetIconSize | Získá rozměry obrázků v seznamu obrázků. Všechny obrázky v seznamu obrázků mají stejné rozměry. |
| GetImageCount | Získá počet obrázků v seznamu obrázků. |
| GetImageInfo | Získá informace o obrázku. |
| GetImageRect | Získá ohraničující obdélník obrázku. |
| GetItemFlags | Získá příznaky obrázku. |
| GetOverlayImage | Načte zadaný obrázek ze seznamu obrázků použitých jako překryvné masky. |
| sloučení | Vytvoří novou image zkombinováním dvou existujících imagí. Tato metoda také vytvoří nový seznam imagí, do kterého se má obrázek uložit. |
| odebrat | Odebere obrázek ze seznamu obrázků. |
| Nahradit | Nahradí obrázek v seznamu obrázků novým obrázkem. |
| ReplaceIcon | Nahradí obrázek ikonou nebo kurzorem. |
| SetBkColor | Nastaví barvu pozadí pro seznam obrázků. Tato metoda funguje pouze v případě, že do seznamu obrázků přidáte ikonu nebo použijete IImageList::AddMasked metoda přidat černobílý rastr. Bez masky se celý obrázek nakreslí a barva pozadí není viditelná. |
| SetDragCursorImage | Vytvoří nový obrázek přetažení kombinací zadaného obrázku, což je obvykle obrázek kurzoru myši s aktuálním obrázkem přetažení. |
| SetIconSize | Nastaví rozměry obrázků v seznamu obrázků a odebere všechny obrázky ze seznamu. |
| SetImageCount | Změní velikost existujícího seznamu obrázků. |
| SetOverlayImage | Přidá zadaný obrázek do seznamu obrázků použitých jako překryvné masky. Seznam obrázků může mít až čtyři překryvné masky v běžných ovládacích prvcích verze 4.70 a starší a až 15 ve verzi 4.71 nebo novější. Metoda přiřadí index překryvné masky zadanému obrázku. |
Struktury
| Námět | Obsah |
|---|---|
| IMAGEINFO | Obsahuje informace o obrázku v seznamu obrázků. Tato struktura se používá s funkcí IImageList::GetImageInfo. |
| IMAGELISTDRAWPARAMS | Obsahuje informace o operaci kreslení seznamu obrázků a používá se s funkcí IImageList::D raw. |