List View

Category Requires Version
Layout > Lists API 19, Android 4.4 - 4.4.4 KitKat 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

Font Italic

Boolean Default: False ➖ Write - Designer

Font Size

Number Default: 22 ➖ Read Write - Designer Blocks

The text size of the listview items.

Font Typeface

Number Default: 0 ➖ Write - Designer

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

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.


Last update: January 27, 2020