Image Lists
Type
widget
Description
Image Lists display a collection of images in an organized list.
An image list consists of several elements, each of which contains an image and, optionally, supporting content (ie a text label).
Compatibility and Support
OS
mac
windows
linux
ios
android
Platforms
desktop
mobile
web
Children Properties
Message
| Name | Summary | Syntax |
|---|---|---|
| loadBeginning | Message generated before updating itemData property value. | on loadBeginning |
| loadProgress | This message is sent when one of the tiles in the image list is finished loading. | on loadProgress <pLoaded>, <pTotal>, <pUnresolvedImages> |
| loadFinished | This message is sent when all the tiles in the image list have finished loading. Parameters: | on loadFinished <pLoaded>, <pTotal>, <pUnresolvedImages> |
| itemMouseEnter | This message is sent when the mouse enter into an item's rectangle. | on itemMouseEnter <pItemNumber>, <pItemProperties> |
| itemMouseLeave | This message is sent when the mouse leaves into an item's rectangle. | on itemMouseLeave <pItemNumber>, <pItemProperties> |
| longTouch | Sent when the touch persists. | on longTouch <pButton>, <pItemNumber>, <pItemProperties> |
| itemClicked | Message sent when an item in the image list is clicked | on itemClicked <pButton>, <pItemNumber>, <pItemProperties> |
| actionClicked | Message sent when an action icon in the image list is clicked | on actionClicked <pButton>, <pItemNumber>, <pItemProperties> |
Property
| Name | Summary | Syntax |
|---|---|---|
| useTitle | Defines if the title is displayed. | get the useTitle of <widget> Syntax: set the useTitle of <widget> to { <true> | <false>} |
| titleStyle | Specifies the style of the title text of the image lists item. | get the titleStyle of <widget> set the titleStyle of <widget> to <integer> |
| itemBorderColor | Specifies the color with which the borders of the image list are drawn. | get the itemBorderColor of <widget> set the itemBorderColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |
| subtitleColor | The color of the item's subtitle. | get the subtitleColor of <widget> set the subtitleColor of <widget> to <integer> |
| subtitleFont | The font name of the item's subtitle. | get the subtitleFont of <widget> set the subtitleFont of <widget> to <integer> |
| hoverIconColor | The color with which the icon is drawn when the pointer is over the item of image lists. | get the hoverIconColor of <widget> set the hoverIconColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |
| rowHeight | The height of one row in px. | get the rowHeight of <widget> set the rowHeight of <widget> to {"auto" | <integer>} |
| categories | The category list of the image list items. | get the categories of <widget> |
| variant | The variant to use. | get the variant of <widget> set the variant of <widget> to {"standard"|"quilted"|"woven"|"masonry"|"single line"} |
| itemOpaque | Specifies whether the interior of the image list items is opaque or transparent to the objects below. | get the itemOpaque of <widget> set the itemOpaque of <widget> to {<true> | <false>} |
| accessible | When true, indicates the image is an accessibility element. | get the accessible of <widget> set the accessible of <widget> to {<true> | <false>} |
| titleAlign | Specifies the align of the title text of the image lists item. | get the titleAlign of <widget> set the titleAlign of <widget> to {"left" | "center" | "right"} |
| itemBarHeight | Defines the height of the item bar. | get the itemBarHeight of <widget> set the itemBarHeight of <widget> to <integer> |
| titleColor | The color of the item's title. | get the titleColor of <widget> set the titleColor of <widget> to <integer> |
| itemBarColor | The color that the text protection of each item in the list of images will have | get the itemBarColor of <widget> set the itemBarColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |
| itemBackColor | Specifies the color with which the background of the items in the list of images is drawn. | get the itemBackColor of <widget> set the itemBackColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |
| subtitleSize | The size of the item's subtitle. | get the subtitleSize of <widget> set the subtitleSize of <widget> to <integer> |
| useSubtitle | Defines if the subtitle is displayed. | get the useSubtitle of <widget> set the useSubtitle of <widget> to {<true> | <false>} |
| iconSize | The size of the item's action icon. | get the iconSize of <widget> set the iconSize of <widget> to <integer> |
| defaultIcon | An Icon to be used as secondary action target. | get the defaultIcon of <widget> set the defaultIcon of <widget> to <pIconName> |
| cols | Defines the number of columns that the list of images will have. | get the cols of <widget> set the cols of <widget> to <pColumnsNumber> |
| gap | The gap between items in px. | get the gap of <widget> set the gap of <widget> to <integer> |
| itemsNumber | Reports the total number of items in a imagesList. | get the itemsNumber of <widget> |
| titleFont | The font name of the item's title. | get the titleFont of <widget> set the titleFont of <widget> to <integer> |
| itemBorderWidth | Specifies the thickness with which the borders of the image list are drawn. | get the itemBorderWidth of <widget> set the itemBorderWidth of <widget> to <integer> |
| itemBarOpacity | A value between 0 and 100 for the opacity of the Image lists itemBar. | get the itemBarOpacity of <widget> set the itemBarOpacity of <widget> to <integer> |
| themeData | The theme mappings of this widget | set the themeData of <widget> to {<array>} get the themeData of <widget> |
| subtitleStyle | Specifies the style of the subtitle text of the image lists item. | get the subtitleStyle of <widget> set the subtitleStyle of <widget> to <integer> |
| itemData | Sorted array with the list of images to load and their properties. | get the itemData of <widget> set the itemData of <widget> to <pImageListArray> |
| itemBar | Defines if the title bar is used. | get the itemBar of <widget> set the itemBar of <widget> to { <true> | <false>} |
| hilitedIconColor | The color of the highlighted action icon that all items will have. | get the hilitedIconColor of <widget> set the hilitedIconColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |
| subtitleAlign | Specifies the align of the subtitle text of the image lists item. | get the subtitleAlign of <widget> set the subtitleAlign of <widget> to {"left" | "center" | "right"} |
| itemThreeD | Specifies whether an item of image lists appears to stick out of or recede into the screen. | get the itemThreeD of <widget> set the itemThreeD of <widget> to {<true> | <false>} |
| titleSize | The size of the item's title. | get the titleSize of <widget> set the titleSize of <widget> to <integer> |
| position | Position of the title bar. | get the position of <widget> set the position of <widget> to {<below> | <bottom> | <top>} |
| defaultSource | A static image to display while loading the image source. | get the defaultSource of <widget> set the defaultSource of <widget> to {<Image ID> | <Image Name> } |
| backgroundOpacity | A value between 0 and 100 for the opacity of the Image lists background. | get the backgroundOpacity of <widget> set the backgroundOpacity of <widget> to <integer> |
| actionPosition | The position of the icon to use as the secondary action target. | get the actionPosition of <widget> set the actionPosition of <widget> to {<left>| <right>} |
| useActionIcon | Defines if the action icon is used. | get the useActionIcon of <widget> set the useActionIcon of <widget> to { <true> | <false>} |
| iconColor | The color of the action icon that all items will have. | get the iconColor of <widget> set the iconColor of <widget> to {<RGB Color> | <HEX Color> | <Color name>} |