Компонент ImageList предназначен для хранения коллекции изображений.
Все изображения имеют одинаковый размер. Размер определяется с помощью свойств Height и Width либо в редакторе компонента.
Каждое изображение, загруженное в компонент, имеет свой индекс, с помощью которого происходит обращение к нему.
Загрузка изображений производится в окне «Редактор списка пиктограмм». Для открытия данного окна необходимо дважды щелкнуть по компоненту на форме либо выполнить соответствующую команду контекстного меню, вызываемого для компонента:
Загрузка производится посредством стандартного окна открытия файла, открываемого с помощью кнопки «Добавить...». Если загружаемое изображение имеет высоту большую, чем установлена в компоненте, то будет выдан запрос на изменение текущих настроек компонента. При утвердительном ответе размеры в компоненте будут изменены, иначе разбивка будет производиться с исходными размерами. Изображения, которые имели меньшие размеры, будут увеличены. Добавленная область будет закрашена установленным цветом заливки. Если в списке уже присутствуют ранее загруженные изображения, то новые будут добавлены в конец списка.
Изображения в списке можно перемещать, используя Drag&Drop. При перемещении будут изменены индексы всех смещенных изображений.
Удаление выделенного изображения производится с помощью кнопки «Удалить». Кнопка «Очистить» удаляет все загруженные изображения.
Используя кнопку «Сохранить выделенные», выделенные пиктограммы можно сохранить на диск в виде одного файла либо в виде отдельных изображений. При сохранении в отдельные изображения наименования файлов формируются в следующем формате: <наименование компонента ImageList>_<индекс изображения>.bmp.
Для изображений можно задать цвет заливки и прозрачный цвет. Для этого необходимо воспользоваться одноименными раскрывающимися списками выбора цвета. Данные цвета будут использованы при формировании конечных изображений, которые будут отображены в компонентах.
Компонент ImageList может загружать изображения в следующих форматах: bmp, jpg, gif, tiff, jpeg, png, ico. Также поддерживаются изображения с альфа-каналом: в формате gif с простой бинарной прозрачностью и в формате png с частичной прозрачностью.
Примечание. Все загружаемые в компонент bmp-файлы должны быть в формате TrueColor.
Кнопка «Изменить» позволяет изменить размеры изображений и переразбить все загруженные изображения.
| Имя свойства | Краткое описание | |
 |
ComponentCount | Свойство ComponentCount возвращает количество дочерних компонентов. |
|
Components | Свойство Components возвращает дочерний компонент. |
|
Count | Свойство Count возвращает количество изображений, загруженных в коллекцию компонента. |
|
Data | Свойство Data предназначено для хранения любых пользовательских данных. |
|
Height | Свойство Height определяет высоту изображений, хранящихся в коллекции компонента. |
|
Icon | Свойство Icon возвращает указанное графическое изображение в виде пиктограммы. |
|
Item | Свойство Item возвращает указанное графическое изображение. |
|
Name | Свойство Name определяет наименование компонента. |
|
Tag | Свойство Tag не используется компилятором. Пользователь может изменить значение свойства Tag и использовать его по своему усмотрению. |
|
Width | Свойство Width определяет ширину изображений, хранящихся в коллекции компонента. |
| Имя метода | Краткое описание | |
 |
Add | Метод Add добавляет изображение в коллекцию компонента. |
|
AddIcon | Метод AddIcon добавляет пиктограмму в коллекцию компонента. |
|
Clear | Метод Clear осуществляет очистку коллекции изображений компонента. |
|
LoadFromFile | Метод LoadFromFile осуществляет загрузку изображения в компонент из файла. |
|
LoadFromStream | Метод LoadFromStream осуществляет загрузку изображения в компонент из потока. |
|
LoadFromStream2 | Метод LoadFromStream2 осуществляет загрузку изображений из потока с восстановлением информации о полупрозрачности. |
|
Remove | Метод Remove удаляет изображение из коллекции. |
|
SaveToDoc | Метод SaveToDoc сохраняет все изображения из компонента в файл. |
|
SaveToStream | Метод SaveToStream сохраняет все изображения из компонента в поток. |
|
SaveToStream2 | Метод SaveToStream2 сохраняет изображения в поток с сохранением информации о полупрозрачности. |
|
SetOverlay | Метод SetOverlay идентифицирует изображение в списке как изображение, которое может быть использовано как покрывающая маска. |
См. также: