ListView

Definition

This is a visible component that displays a list of text and image elements in your Screen to display. Simple lists of strings may be set using the ElementsFromString property. More complex lists of elements containing multiple strings and/or images can be created using the ListData and ListViewLayout properties.

Information on Layouts

Warning: This component will not work correctly on Screens that are scrollable if its Height is set to Fill Parent.

Properties

BackgroundColor

The color of the ListView background.

Elements

Specifies the list of choices to display.

ElementsFromString

Set the list of choices specified as a string with the elements separated by commas such as: Cheese,Fruit,Bacon,Radish.

FontSizeDetail

Specifies the ListView item’s text font size

FontTypeface

Specifies the label’s text’s font face as default, serif, sans serif, or monospace.

FontTypefaceDetail

Specifies the label’s text’s font face as default, serif, sans serif, or monospace.

Height

Specifies the ListView’s vertical height, measured in pixels.

HeightPercent

Specifies the ListView’s vertical height as a percentage of the Screen’s Height.

ImageHeight

Specifies the image height of ListView layouts containing images

ImageWidth

Specifies the image width of ListView layouts containing images

ListData

Specifies data to be displayed in the ListView elements. This property sets the elements specified in ListViewLayout. For example, if the chosen layout is Image,MainText this property will allow any number of elements to be defined, each containing a filename for Image and a string for MainText. Designer only property.

ListViewLayout

Specifies type of layout for ListView row. Designer only property.

Orientation

Specifies the layout’s orientation. This may be: Vertical, which displays elements in rows one after the other; or Horizontal, which displays one element at a time and allows the user to swipe left or right to brows the elements.

Selection

Returns the text in the ListView at the position of SelectionIndex.

SelectionColor

The color of the item when it is selected.

SelectionDetailText

Returns the Secondary or Detail text in the ListView at the position set by SelectionIndex

SelectionIndex

The index of the currently selected item, starting at 1. If no item is selected, the value will be 0. If an attempt is made to set this to a number less than 1 or greater than the number of items in the ListView, SelectionIndex will be set to 0, and Selection will be set to the empty text.

ShowFilterBar

Sets visibility of the filter bar. true will show the bar, false will hide it.

TextColor

The text color of the ListView items.

TextColorDetail

Specifies the color of the secondary text in a ListView layout

TextSize

Specifies the ListView item’s text font size

Visible

Specifies whether the ListView should be visible on the screen. Value is true if the ListView is showing and false if hidden.

Width

Specifies the horizontal width of the ListView, measured in pixels.

WidthPercent

Specifies the horizontal width of the ListView as a percentage of the Screen’s Width.