List View¶
| Category | Requires | Version |
|---|---|---|
| Layout > Lists | API 21, Android 5.0 Lollipop | 13 |
Overview¶
This is a visible component that displays a list of text elements.
The list can be set using the ElementsFromString property or using the Elements block in the blocks editor.
Events¶
After Picking¶
Simple event to be raised after the an element has been chosen in the list. The selected element is available in the Selection property.
Long Click¶
Simple event to be raised after the an element has been chosen in the list via long click. The selected element is available in the Selection property.
Methods¶
Clear List¶
Remove all the items from the list
Properties¶
Background Color¶
Color Default: #607D8BFF 
Read Write - Designer Blocks
The color of the listview background.
Divider Color¶
Available as Advanced Property
Color Default: #000000FF Read Write - Designer Blocks
Set the divider color
Divider Height¶
Available as Advanced Property
Number Default: 2 Read Write - Designer Blocks
Set the divider height.
Elements¶
List Read Write - Blocks
List of text elements to show in the ListView.
Elements From String¶
Text Write - Designer Blocks
The ListView elements specified as a string with the items separated by commas such as: Cheese,Fruit,Bacon,Radish. Each word before the comma will be an element in the list.
Filter Bar Hint¶
Text Default: Search list... Read Write - Designer Blocks
The hint that will be displayed in the filter bar.
Font Bold¶
Boolean Default: False Write - Designer
Property for FontBold
Font Italic¶
Boolean Default: False Write - Designer
Property for FontItalic
Font Size¶
Number Default: 22 Read Write - Designer Blocks
The text size of the listview items.
Font Typeface¶
Number Default: 0 Write - Designer
Property for FontTypeface
Font Typeface Import¶
Available as Advanced Property
Text Write - Designer Blocks
Set a custom font.
Height¶
Number Read Write - Blocks
Determines the height of the list on the view.
Height Percent¶
Number Write - Blocks
Specifies the component's vertical height as a percentageof the height of its parent Component.
HTML Format¶
Available as Advanced Property
Boolean Default: True Read Write - Designer Blocks
Returns true if html is enabled.
Item Height in %¶
Number Default: 10 Read Write - Designer Blocks
Set the listview item height. If you write 10, that means the item height will be 10 percent of the device screen height.
Long Click Enabled¶
Available as Advanced Property
Boolean Default: False Read Write - Designer Blocks
If true long click on items are enabled, else long click is disabled.
Scroll To Position¶
Number Write - Blocks
Smoothly scroll to the specified position. The listview will scroll such that the indicated position is displayed.
Scrollbar Fading¶
Boolean Default: True Read Write - Designer Blocks
Return the state of ScrollbarFading. If ScrollbarFading is enabled returns true.
Scrolling Speed¶
Number Default: 1.0 Read Write - Designer Blocks
The amount of friction applied to flings.
Search Hint Color¶
Available as Advanced Property
Color Default: #CCCCCCFF Read Write - Designer Blocks
The color of the search hint text.
Search Text Color¶
Color Default: #FFFFFFFF Read Write - Designer Blocks
The color of the search text.
Search Text Size¶
Number Default: 14.0 Read Write - Designer Blocks
The text size of the search text.
Selection¶
Text Read Write - Designer Blocks
Set the selection to the ListView.
Selection Color¶
Color Default: #CCCCCCFF Read Write - Designer Blocks
The color of the item when it is selected.
Selection Index¶
Number Read Write - Blocks
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.
Show Filter Bar¶
Boolean Default: False Read Write - Designer Blocks
Sets visibility of ShowFilterBar. True will show the bar, False will hide it.
Show Scrollbar¶
Boolean Default: True Read Write - Designer Blocks
Return the state of ShowScrollbar. If ShowScrollbar is enabled returns true.
Show Selection Color¶
Available as Advanced Property
Boolean Default: False Write - Designer
Sets visibility of ShowSelectionColor. True will show the selection color on a selected item, False will hide it.
Text Alignment¶
Number Default: 0 Write - Designer
Property for TextAlignment
Text Color¶
Color Default: #000000FF Read Write - Designer Blocks
The text color of the listview items.
Visible¶
Boolean Default: True Read Write - Designer Blocks
Returns true iff the component is visible.
Width¶
Number Read Write - Blocks
Determines the width of the list on the view.
Width Percent¶
Number Write - Blocks
Specifies the component's horizontal width as a percentageof the Width of its parent Component.