Listy obrazów
Ta sekcja zawiera informacje o elementach programowania używanych z listami obrazów.
Przeglądy
| Temat | Treść |
|---|---|
| listy obrazów | Lista obrazów jest kolekcją obrazów o tym samym rozmiarze, z których każdy może być określany przez jego indeks. |
Funkcje
| Temat | Treść |
|---|---|
| HIMAGELIST_QueryInterface | Pobiera wskaźnik do obiektu IImageList lub IImageList2, który odpowiada dojściu HIMAGELIST listy obrazów. |
| ImageList_Add | Dodaje obraz lub obrazy do listy obrazów. |
| ImageList_AddMasked | Dodaje obraz lub obrazy do listy obrazów, generując maskę z określonej mapy bitowej. |
| ImageList_BeginDrag | Rozpoczyna przeciąganie obrazu. |
| ImageList_CoCreateInstance | Tworzy pojedyncze wystąpienie listy obrazów i zwraca do niego wskaźnik interfejsu. |
| ImageList_Copy | Kopiuje obrazy na danej liście obrazów. |
| ImageList_Create | Tworzy nową listę obrazów. |
| ImageList_Destroy | Niszczy listę obrazów. |
| ImageList_DragEnter | Wyświetla obraz przeciągania w określonej pozycji w oknie. |
| ImageList_DragLeave | Odblokuje określone okno i ukrywa obraz przeciągania, co umożliwia zaktualizowanie okna. |
| ImageList_DragMove | Przenosi obraz przeciągany podczas operacji przeciągania i upuszczania. Ta funkcja jest zwykle wywoływana w odpowiedzi na komunikat WM_MOUSEMOVE. |
| ImageList_DragShowNolock | Pokazuje lub ukrywa przeciągnięty obraz. |
| ImageList_Draw | Rysuje element listy obrazów w określonym kontekście urządzenia. |
| ImageList_DrawEx | Rysuje element listy obrazów w określonym kontekście urządzenia. Funkcja używa określonego stylu rysunku i łączy obraz z określonym kolorem. |
| ImageList_DrawIndirect | Rysuje obraz listy obrazów na podstawie struktury IMAGELISTDRAWPARAMS. |
| ImageList_Duplicate | Tworzy duplikat istniejącej listy obrazów. |
| ImageList_EndDrag | Kończy operację przeciągania. |
| ImageList_GetBkColor | Pobiera bieżący kolor tła dla listy obrazów. |
| ImageList_GetDragImage | Pobiera tymczasową listę obrazów używaną do przeciągania obrazu. Funkcja pobiera również bieżące położenie przeciągania i przesunięcie obrazu przeciągania względem położenia przeciągania. |
| ImageList_GetIcon | Tworzy ikonę na podstawie obrazu i maski na liście obrazów. |
| ImageList_GetIconSize | Pobiera wymiary obrazów na liście obrazów. Wszystkie obrazy na liście obrazów mają te same wymiary. |
| ImageList_GetImageCount | Pobiera liczbę obrazów na liście obrazów. |
| ImageList_GetImageInfo | Pobiera informacje o obrazie. |
| ImageList_LoadImage | Tworzy listę obrazów na podstawie określonej mapy bitowej. |
| ImageList_Merge | Tworzy nowy obraz, łącząc dwa istniejące obrazy. Funkcja tworzy również nową listę obrazów, na której ma być przechowywany obraz. |
| ImageList_Read | Odczytuje listę obrazów ze strumienia. |
| ImageList_ReadEx | Odczytuje listę obrazów ze strumienia i zwraca interfejs do listy obrazów. |
| ImageList_Remove | Usuwa obraz z listy obrazów. |
| ImageList_Replace | Zamienia obraz na liście obrazów na nowy obraz. |
| ImageList_ReplaceIcon | Zamienia obraz ikoną lub kursorem. |
| ImageList_SetBkColor | Ustawia kolor tła listy obrazów. Ta funkcja działa tylko wtedy, gdy dodasz ikonę lub użyjesz ImageList_AddMasked z czarną i białą mapą bitową. Bez maski cały obraz jest rysowany; dlatego kolor tła nie jest widoczny. |
| ImageList_SetColorTable | Ustawia tabelę kolorów dla listy obrazów. |
| ImageList_SetDragCursorImage | Tworzy nowy obraz przeciągania, łącząc określony obraz (zazwyczaj obraz kursora myszy) z bieżącym obrazem przeciągania. |
| ImageList_SetIconSize | Ustawia wymiary obrazów na liście obrazów i usuwa wszystkie obrazy z listy. |
| ImageList_SetImageCount | Zmienia rozmiar istniejącej listy obrazów. |
| ImageList_SetOverlayImage | Dodaje określony obraz do listy obrazów, które mają być używane jako maski nakładki. Lista obrazów może zawierać maksymalnie cztery maski nakładki w wersji 4.70 lub starszej i do 15 w wersji 4.71. Funkcja przypisuje indeks maski nakładki do określonego obrazu. |
| ImageList_Write | Zapisuje listę obrazów w strumieniu. |
| ImageList_WriteEx | Zapisuje listę obrazów w strumieniu. |
Makra
| Temat | Treść |
|---|---|
| ImageList_AddIcon | Dodaje ikonę lub kursor do listy obrazów.
ImageList_AddIcon wywołuje funkcję ImageList_ReplaceIcon. |
| ImageList_ExtractIcon | Wywołuje funkcję ImageList_GetIcon, aby utworzyć ikonę lub kursor na podstawie obrazu i maski na liście obrazów. |
| ImageList_LoadBitmap | Wywołuje funkcję ImageList_LoadImage, aby utworzyć listę obrazów z określonego zasobu mapy bitowej. |
| ImageList_RemoveAll | Wywołuje funkcję ImageList_Remove, aby usunąć wszystkie obrazy z listy obrazów. |
| INDEXTOOVERLAYMASK | Przygotowuje indeks maski nakładki, aby funkcja ImageList_Draw mogła jej używać. |
Interfejsów
| Temat | Treść |
|---|---|
| IImageList | Uwidacznia metody, które manipulują listami obrazów i współdziałają z nimi. Aby użyć IImageList, określ Comctl32.dll wersję 6 w manifeście. Jeśli tego nie zrobisz, Comctl32.dll wersja 5 będzie używana domyślnie, z którym IImageList może wyświetlać nieprzewidywalne zachowanie. Aby uzyskać więcej informacji na temat manifestów, zobacz Włączanie stylów wizualnych. |
Metody
| Temat | Treść |
|---|---|
| Dodaj | Dodaje obraz lub obrazy do listy obrazów. |
| AddMasked | Dodaje obraz lub obrazy do listy obrazów, generując maskę z określonej mapy bitowej. |
| BeginDrag | Rozpoczyna przeciąganie obrazu. |
| Klonowanie | Klonuje istniejącą listę obrazów. |
| kopiowanie | Kopiuje obrazy z danej listy obrazów. |
| dragEnter | Blokuje określone okno podczas operacji przeciągania i wyświetla obraz przeciągania w określonej pozycji w oknie. |
| DragLeave | Odblokowuje określone okno i ukrywa obraz przeciągania, co umożliwia aktualizowanie okna. |
| DragMove | Przenosi obraz przeciągany podczas operacji przeciągania i upuszczania. Ta funkcja jest zwykle wywoływana w odpowiedzi na komunikat WM_MOUSEMOVE. |
| DragShowNolock | Pokazuje lub ukrywa przeciągnięty obraz. |
| Draw | Rysuje element listy obrazów w określonym kontekście urządzenia. |
| EndDrag | Kończy operację przeciągania. |
| GetBkColor | Pobiera bieżący kolor tła dla listy obrazów. |
| GetDragImage | Pobiera tymczasową listę obrazów używaną do przeciągania obrazu. Funkcja pobiera również bieżące położenie przeciągania i przesunięcie obrazu przeciągania względem położenia przeciągania. |
| GetIcon | Tworzy ikonę na podstawie obrazu i maski na liście obrazów. |
| GetIconSize | Pobiera wymiary obrazów na liście obrazów. Wszystkie obrazy na liście obrazów mają te same wymiary. |
| GetImageCount | Pobiera liczbę obrazów na liście obrazów. |
| GetImageInfo | Pobiera informacje o obrazie. |
| GetImageRect | Pobiera prostokąt ograniczenia obrazu. |
| GetItemFlags | Pobiera flagi obrazu. |
| GetOverlayImage | Pobiera określony obraz z listy obrazów używanych jako maski nakładki. |
| scalanie | Tworzy nowy obraz, łącząc dwa istniejące obrazy. Ta metoda tworzy również nową listę obrazów, w której ma być przechowywany obraz. |
| Usuń | Usuwa obraz z listy obrazów. |
| Zamień | Zamienia obraz na liście obrazów na nowy obraz. |
| ReplaceIcon | Zamienia obraz ikoną lub kursorem. |
| SetBkColor | Ustawia kolor tła listy obrazów. Ta metoda działa tylko w przypadku dodania ikony do listy obrazów lub użycia metody IImageList::AddMasked w celu dodania czarnej i białej mapy bitowej. Bez maski cały obraz rysuje, a kolor tła nie jest widoczny. |
| SetDragCursorImage | Tworzy nowy obraz przeciągania, łącząc określony obraz, który jest zazwyczaj obrazem kursora myszy z bieżącym obrazem przeciągania. |
| SetIconSize | Ustawia wymiary obrazów na liście obrazów i usuwa wszystkie obrazy z listy. |
| SetImageCount | Zmienia rozmiar istniejącej listy obrazów. |
| SetOverlayImage | Dodaje określony obraz do listy obrazów używanych jako maski nakładki. Lista obrazów może zawierać maksymalnie cztery maski nakładki w typowych kontrolkach w wersji 4.70 i starszych oraz maksymalnie 15 w wersji 4.71 lub nowszej. Metoda przypisuje indeks maski nakładki do określonego obrazu. |
Struktur
| Temat | Treść |
|---|---|
| IMAGEINFO | Zawiera informacje o obrazie na liście obrazów. Ta struktura jest używana z IImageList::GetImageInfo funkcji. |
| IMAGELISTDRAWPARAMS | Zawiera informacje o operacji rysowania listy obrazów i jest używany z funkcją IImageList::D raw. |