Class Toolbar

Definition

Namespace:

ElmSharp

Assembly:

ElmSharp.dll

The Toolbar is a widget that displays a list of items inside a box.

public class Toolbar : Widget, IAccessibleObject

Inheritance

object

EvasObject

AccessibleObject

Widget

Toolbar

Implements

IAccessibleObject

Constructors

Toolbar(EvasObject)

Creates and initializes a new instance of the Toolbar class.

Declaration

public Toolbar(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	A EvasObject to which the new Table instance will be attached.

Properties

FirstItem

Gets the first ToolbarItemItem of the toolbar.

Declaration

public ToolbarItem FirstItem { get; }

Property Value

Type	Description
ToolbarItem

Homogeneous

Sets or gets whether the layout of this toolbar is homogeneous.

Declaration

public bool Homogeneous { get; set; }

Property Value

Type	Description
bool

Remarks

True for homogeneous, False for no homogeneous.

IconLookupOrder

Sets or gets the icon lookup order, for toolbar items' icons. The default lookup order is ToolbarIocnLookupOrder.ThemeFreedesktop. Icons added before calling this function will not be affected.

Declaration

public ToolbarIconLookupOrder IconLookupOrder { get; set; }

Property Value

Type	Description
ToolbarIconLookupOrder

IconSize

Sets or gets the icon size of a given toolbar widget. Default value is 32 pixels, to be used by toolbar items.

Declaration

public int IconSize { get; set; }

Property Value

Type	Description
int

ItemAlignment

Sets or gets the alignment of the items.

Declaration

public double ItemAlignment { get; set; }

Property Value

Type	Description
double

Remarks

The toolbar items alignment, a float between 0.0 and 1.0.

ItemsCount

Gets the number of items in a Toolbar widget.

Declaration

public int ItemsCount { get; }

Property Value

Type	Description
int

LastItem

Gets the last ToolbarItemItem of the toolbar.

Declaration

public ToolbarItem LastItem { get; }

Property Value

Type	Description
ToolbarItem

SelectedItem

Gets the selected ToolbarItemItem of the toolbar.

Declaration

public ToolbarItem SelectedItem { get; }

Property Value

Type	Description
ToolbarItem

SelectionMode

Sets or gets the slection mode of a given Toolbar widget.

Declaration

public ToolbarSelectionMode SelectionMode { get; set; }

Property Value

Type	Description
ToolbarSelectionMode

ShrinkMode

Sets or gets the shrink mode of a given Toolbar widget.

Declaration

public ToolbarShrinkMode ShrinkMode { get; set; }

Property Value

Type	Description
ToolbarShrinkMode

TransverseExpansion

Sets or gets the item's transverse expansion of a given Toolbar widget.

Declaration

public bool TransverseExpansion { get; set; }

Property Value

Type	Description
bool

Remarks

The transverse expansion of the item, true for on and false for off. By default it's false.

Methods

Append(string, string)

Appends the ToolbarItem, which contains label and icon to the toolbar.

Declaration

public ToolbarItem Append(string label, string icon)

Parameters

Type	Name	Description
string	label	The label of the item.
string	icon	A string with the icon name or the absolute path of an image file.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is appended to the toolbar.

See Also

Append(string)

Prepend(string)

Prepend(string, string)

Append(string)

Appends the ToolbarItem, which just contains label to the toolbar.

Declaration

public ToolbarItem Append(string label)

Parameters

Type	Name	Description
string	label	The label of the item.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is appended to the toolbar.

See Also

Append(string, string)

Prepend(string)

CreateHandle(EvasObject)

Creates a widget handle.

Declaration

protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject.

Returns

Type	Description
System.IntPtr	Handle IntPtr.

Overrides

EvasObject.CreateHandle(EvasObject)

FindItemByLabel(string)

Finds the item with that label in the toolbar.

Declaration

public ToolbarItem FindItemByLabel(string label)

Parameters

Type	Name	Description
string	label	The label of the item.

Returns

Type	Description
ToolbarItem	The ToolbarItem into the toolbar.

InsertAfter(ToolbarItem, string, string)

Inserts a new item which contains label and icon into the toolbar object after item after.

Declaration

public ToolbarItem InsertAfter(ToolbarItem after, string label, string icon)

Parameters

Type	Name	Description
ToolbarItem	after	The toolbar item to insert after.
string	label	The label of the item.
string	icon	A string with the icon name or the absolute path of an image file.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is inserted into the toolbar.

InsertBefore(ToolbarItem, string, string)

Inserts a new item which contains label and icon into the toolbar object before item before.

Declaration

public ToolbarItem InsertBefore(ToolbarItem before, string label, string icon)

Parameters

Type	Name	Description
ToolbarItem	before	The toolbar item to insert before.
string	label	The label of the item.
string	icon	A string with the icon name or the absolute path of an image file.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is inserted into the toolbar.

See Also

InsertBefore(ToolbarItem, string)

InsertBefore(ToolbarItem, string)

Inserts a new item which just contains label into the toolbar object before item before.

Declaration

public ToolbarItem InsertBefore(ToolbarItem before, string label)

Parameters

Type	Name	Description
ToolbarItem	before	The toolbar item to insert before.
string	label	The label of the item.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is inserted into the toolbar.

See Also

InsertBefore(ToolbarItem, string, string)

Prepend(string, string)

Prepends the ToolbarItem, which contains label and icon to the toolbar.

Declaration

public ToolbarItem Prepend(string label, string icon)

Parameters

Type	Name	Description
string	label	The label of the item.
string	icon	A string with the icon name or the absolute path of an image file.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is prepended to the toolbar.

See Also

Append(string)

Append(string, string)

Prepend(string)

Prepend(string)

Prepends the ToolbarItem, which just contains label to the toolbar.

Declaration

public ToolbarItem Prepend(string label)

Parameters

Type	Name	Description
string	label	The label of the item.

Returns

Type	Description
ToolbarItem	The new ToolbarItem which is prepended to the toolbar.

See Also

Append(string)

Append(string, string)

Prepend(string, string)

Events

Selected

Selected will be triggered when toolbar has been selected.

Declaration

public event EventHandler<ToolbarItemEventArgs> Selected

Event Type

Type	Description
System.EventHandler<TEventArgs><ToolbarItemEventArgs>

Implements

IAccessibleObject

Extension Methods

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Deactivate(EvasObject)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)