Class List

Definition

Namespace:

ElmSharp

Assembly:

ElmSharp.dll

API Level:

preview

It inherits Layout. The List is a widget that aims to display a simple list item which has 2 icons, 1 text, and can be selected. For more robust lists, GenList should probably be used.

public class List : Layout, IAccessibleObject

Inheritance

Object

EvasObject

AccessibleObject

Widget

Container

Layout

List

Implements

IAccessibleObject

Constructors

List(EvasObject)

Creates and initializes a new instance of the List class.

Declaration

public List(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	The parent is a given container, which will be attached by the list as a child. It's EvasObject type.

API Level: preview

Properties

Mode

Gets or sets which mode to be used for the list.

Declaration

public ListMode Mode { get; set; }

Property Value

Type	Description
ListMode

API Level: preview

SelectedItem

Gets the selected item.

Declaration

public ListItem SelectedItem { get; }

Property Value

Type	Description
ListItem

API Level: preview

Methods

Append(String)

Appends a new item with a text to the end of a given list widget.

Declaration

public ListItem Append(string label)

Parameters

Type	Name	Description
String	label	The text for the item.

Returns

Type	Description
ListItem	Return a new added list item that contains a text.

See Also

ListItem

API Level: preview

Append(String, EvasObject, EvasObject)

Appends a new item with a text and 2 icons to the end of a given list widget.

Declaration

public ListItem Append(string label, EvasObject leftIcon, EvasObject rightIcon)

Parameters

Type	Name	Description
String	label	The text for the item.
EvasObject	leftIcon	The left icon for the item.
EvasObject	rightIcon	The right icon for the item.

Returns

Type	Description
ListItem	Return a new added list item that contains a text and 2 icons.

See Also

ListItem

API Level: preview

Clear()

Removes all the items from a given list widget. To delete just one item, use Delete().

Declaration

public void Clear()

API Level: preview

CreateHandle(EvasObject)

Creates a widget handle.

Declaration

protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject.

Returns

Type	Description
IntPtr	Handle IntPtr.

Overrides

Layout.CreateHandle(EvasObject)

API Level: preview

Prepend(String)

Prepends a new item with a text to the beginning of a given list widget.

Declaration

public ListItem Prepend(string label)

Parameters

Type	Name	Description
String	label	The text for the item.

Returns

Type	Description
ListItem	Return a new added list item that contains a text.

API Level: preview

Prepend(String, EvasObject, EvasObject)

Prepends a new item with a text and 2 icons to the beginning of a given list widget.

Declaration

public ListItem Prepend(string label, EvasObject leftIcon, EvasObject rigthIcon)

Parameters

Type	Name	Description
String	label	The text for the item.
EvasObject	leftIcon	The left icon for the item.
EvasObject	rigthIcon	The right icon for the item.

Returns

Type	Description
ListItem	Return a new added list item that contains a text and 2 icons.

API Level: preview

Update()

Starts the list. Called before running Show() on the list object. If not called, it won't display the list properly.

Declaration

public void Update()

API Level: preview

Events

ItemActivated

ItemActivated is raised when a new list item is double-clicked or pressed (enter|return|spacebar).

Declaration

public event EventHandler<ListItemEventArgs> ItemActivated

Event Type

Type	Description
EventHandler<ListItemEventArgs>

API Level: preview

ItemDoubleClicked

ItemDoubleClicked is raised when a new list item is double-clicked.

Declaration

public event EventHandler<ListItemEventArgs> ItemDoubleClicked

Event Type

Type	Description
EventHandler<ListItemEventArgs>

API Level: preview

ItemLongPressed

ItemLongPressed is raised when a list item is pressed for a certain amount of time. By default, it's 1 second.

Declaration

public event EventHandler<ListItemEventArgs> ItemLongPressed

Event Type

Type	Description
EventHandler<ListItemEventArgs>

API Level: preview

ItemSelected

ItemSelected is raised when a new list item is selected.

Declaration

public event EventHandler<ListItemEventArgs> ItemSelected

Event Type

Type	Description
EventHandler<ListItemEventArgs>

API Level: preview

ItemUnselected

ItemUnselected is raised when a list item is Unselected.

Declaration

public event EventHandler<ListItemEventArgs> ItemUnselected

Event Type

Type	Description
EventHandler<ListItemEventArgs>

API Level: preview

Implements

IAccessibleObject

Extension Methods

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.Deactivate(EvasObject)

See Also

GenList

GenGrid