class sap.m.ToolbarSpacer

Control sample: sap.m.ToolbarSpacer
Visiblity: public
UX Guidelines:
Implements:
Available since: N/A
Module: sap/m/ToolbarSpacer
Application Component: CA-UI5-CTR

Adds horizontal space between the items used within a sap.m.Toolbar.

Note: The sap.m.ToolbarSpacer is a flex control that is intended to control its own behavior, thus sap.m.ToolbarLayoutData is not supported as value for the layoutData aggregation of sap.m.ToolbarSpacer and if set it's ignored.


Constructor

Constructor for a new ToolbarSpacer.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject#constructor for a general description of the syntax of the settings object.

new sap.m.ToolbarSpacer(sId?, mSettings?)
Param Type Default Value Description
sId? string

ID for the new control, generated automatically if no ID is given

mSettings? object

Initial settings for the new control


Properties

Name Type Default Value Description
width sap.ui.core.CSSSize empty string

Defines the width of the horizontal space. Note: Empty("") value makes the space flexible which means it covers the remaining space between toolbar items. This feature can be used to push next item to the edge of the toolbar.

Visibility: public

Methods Overview

Method Description
sap.m.ToolbarSpacer.extend

Creates a new subclass of class sap.m.ToolbarSpacer with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

sap.m.ToolbarSpacer.getMetadata

Returns a metadata object for class sap.m.ToolbarSpacer.

getWidth

Gets current value of property width.

Defines the width of the horizontal space. Note: Empty("") value makes the space flexible which means it covers the remaining space between toolbar items. This feature can be used to push next item to the edge of the toolbar.

Default value is empty string.

setWidth

Sets a new value for property width.

Defines the width of the horizontal space. Note: Empty("") value makes the space flexible which means it covers the remaining space between toolbar items. This feature can be used to push next item to the edge of the toolbar.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is empty string.

sap.m.ToolbarSpacer.extend

Creates a new subclass of class sap.m.ToolbarSpacer with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Param Type DefaultValue Description
sClassName string

Name of the class being created

oClassInfo object

Object literal with information about the class

FNMetaImpl function

Constructor function for the metadata object; if not given, it defaults to the metadata implementation used by this class

sap.m.ToolbarSpacer.getMetadata

Returns a metadata object for class sap.m.ToolbarSpacer.

getWidth

Gets current value of property width.

Defines the width of the horizontal space. Note: Empty("") value makes the space flexible which means it covers the remaining space between toolbar items. This feature can be used to push next item to the edge of the toolbar.

Default value is empty string.

setWidth

Sets a new value for property width.

Defines the width of the horizontal space. Note: Empty("") value makes the space flexible which means it covers the remaining space between toolbar items. This feature can be used to push next item to the edge of the toolbar.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is empty string.

Param Type DefaultValue Description
sWidth sap.ui.core.CSSSize ''

New value for property width