Class: Label
Extends
Implements
Constructors
new Label()
new Label(
options
):Label
Single or multi-line text formatted and rendered on the screen.
Parameters
• options: LabelOptions
= {}
Returns
Remarks
Label (in contrast to TextLine) has enhanced text support for line wrapping, centering/alignment, and background colors.
Overrides
Defined in
Label.ts:62
Properties
_alpha
_alpha:
number
=1.0
Inherited from
Defined in
M2Node.ts:98
_draggable
protected
_draggable:boolean
=false
Inherited from
Defined in
M2Node.ts:101
_game?
optional
_game:Game
Inherited from
Defined in
M2Node.ts:105
_hidden
protected
_hidden:boolean
=false
Inherited from
Defined in
M2Node.ts:102
_isUserInteractionEnabled
protected
_isUserInteractionEnabled:boolean
=false
Inherited from
M2Node
._isUserInteractionEnabled
Defined in
M2Node.ts:100
_position
_position:
Point
Inherited from
Defined in
M2Node.ts:96
_scale
_scale:
number
=1.0
Inherited from
Defined in
M2Node.ts:97
_size
protected
_size:Size
Inherited from
Defined in
M2Node.ts:109
_zRotation
_zRotation:
number
=0
Inherited from
Defined in
M2Node.ts:99
absoluteAlpha
absoluteAlpha:
number
=1.0
Inherited from
Defined in
M2Node.ts:111
absoluteAlphaChange
absoluteAlphaChange:
number
=0
Inherited from
Defined in
M2Node.ts:112
absolutePosition
absolutePosition:
Point
Inherited from
Defined in
M2Node.ts:108
absoluteScale
absoluteScale:
number
=1.0
Inherited from
Defined in
M2Node.ts:110
actions
actions:
Action
[]
Inherited from
Defined in
M2Node.ts:113
children
children:
M2Node
[]
Inherited from
Defined in
M2Node.ts:107
constructionIso8601TimeStamp
constructionIso8601TimeStamp:
string
Inherited from
M2Node
.constructionIso8601TimeStamp
Defined in
M2Node.ts:92
constructionSequence
constructionSequence:
number
Inherited from
Defined in
M2Node.ts:93
constructionTimeStamp
constructionTimeStamp:
number
Inherited from
Defined in
M2Node.ts:91
dragging
dragging:
boolean
=false
Is the node in a dragging state?
Inherited from
Defined in
M2Node.ts:141
draggingLastPointerOffset
draggingLastPointerOffset:
Point
What was the previous pointer offset when the node was in a dragging state?
Inherited from
M2Node
.draggingLastPointerOffset
Defined in
M2Node.ts:139
eventListeners
eventListeners:
M2NodeEventListener
<M2NodeEvent
>[]
Inherited from
Defined in
M2Node.ts:115
isDrawable
isDrawable:
boolean
=true
Overrides
Defined in
Label.ts:27
isShape
isShape:
boolean
=false
Inherited from
Defined in
M2Node.ts:87
isText
isText:
boolean
=true
Overrides
Defined in
Label.ts:28
layout
layout:
Layout
={}
FOR INTERNAL USE ONLY
Implementation of
Inherited from
Defined in
M2Node.ts:103
loopMessages
loopMessages:
Set
<string
>
Inherited from
Defined in
M2Node.ts:121
name
name:
string
Name of the node. Only needed if the node will be referred to by name in a later function
Implementation of
Inherited from
Defined in
M2Node.ts:95
needsInitialization
needsInitialization:
boolean
=true
Inherited from
Defined in
M2Node.ts:117
nodeEvents
Inherited from
Defined in
M2Node.ts:122
options
options:
M2NodeOptions
Inherited from
Defined in
M2Node.ts:90
parent?
optional
parent:M2Node
Inherited from
Defined in
M2Node.ts:106
pressed
pressed:
boolean
=false
Is the node in a pressed state? E.g., did the user put the pointer down on the node and not yet release it?
Inherited from
Defined in
M2Node.ts:126
pressedAndWithinHitArea
pressedAndWithinHitArea:
boolean
=false
Is the node in a pressed state AND is the pointer within the node's hit area? For example, a user may put the pointer down on the node, but then move the pointer, while still down, beyond the node's hit area. In this case, pressed = true, but pressedAndWithinHitArea = false.
Inherited from
M2Node
.pressedAndWithinHitArea
Defined in
M2Node.ts:132
pressedInitialPointerOffset
pressedInitialPointerOffset:
Point
When the node initially enters the pressed state, what is the pointer offset? (offset from the canvas's origin to the pointer position). We save this because it will be needed if this press then led to a drag.
Inherited from
M2Node
.pressedInitialPointerOffset
Defined in
M2Node.ts:136
queuedAction?
optional
queuedAction:Action
Inherited from
Defined in
M2Node.ts:114
type
readonly
type:Label
=M2NodeType.Label
Overrides
Defined in
Label.ts:26
userData
userData:
any
={}
Inherited from
Defined in
M2Node.ts:120
uuid
readonly
uuid:string
Internal
Unique identifier (UUID). Will be generated automatically. For m2c2kit library use only
Implementation of
Inherited from
Defined in
M2Node.ts:116
withinHitArea
withinHitArea:
boolean
=false
Inherited from
Defined in
M2Node.ts:127
Accessors
alpha
Get Signature
get alpha():
number
Opacity of the node. 0 is fully transparent, 1 is fully opaque. Default is 1.0. Alpha has multiplicative inheritance. For example, if the node's parent is alpha .5 and this node's is alpha .4, then the node will appear with alpha .2.
Returns
number
Set Signature
set alpha(
alpha
):void
Opacity of the node. 0 is fully transparent, 1 is fully opaque. Default is 1.0. Alpha has multiplicative inheritance. For example, if the node's parent is alpha .5 and this node's is alpha .4, then the node will appear with alpha .2.
Parameters
• alpha: number
Returns
void
Opacity of the node. 0 is fully transparent, 1 is fully opaque. Default is 1.0. Alpha has multiplicative inheritance. For example, if the node's parent is alpha .5 and this node's is alpha .4, then the node will appear with alpha .2.
Implementation of
Inherited from
Defined in
M2Node.ts:1383
ancestors
Get Signature
get ancestors():
M2Node
[]
Returns all ancestor nodes, not including the node itself.
Returns
M2Node
[]
Inherited from
Defined in
M2Node.ts:537
anchorPoint
Get Signature
get anchorPoint():
Point
Point within the node that determines its position. Default is { x: 0.5, y: 0.5 }, which centers the node on its position
Returns
Set Signature
set anchorPoint(
anchorPoint
):void
Point within the node that determines its position. Default is { x: 0.5, y: 0.5 }, which centers the node on its position
Parameters
• anchorPoint: Point
Returns
void
Point within the node that determines its position. Default is { x: 0.5, y: 0.5 }, which centers the node on its position
Implementation of
Defined in
Label.ts:473
backgroundColor
Get Signature
get backgroundColor():
undefined
|RgbaColor
Background color of label text. Default is no background color
Returns
undefined
| RgbaColor
Set Signature
set backgroundColor(
backgroundColor
):void
Background color of label text. Default is no background color
Parameters
• backgroundColor: undefined
| RgbaColor
Returns
void
Background color of label text. Default is no background color
Implementation of
Defined in
Label.ts:449
canvasKit
Get Signature
get canvasKit():
CanvasKit
Gets the scene that contains this node by searching up the ancestor tree recursively. Throws exception if node is not part of a scene.
Returns
CanvasKit
Scene that contains this node
Inherited from
Defined in
M2Node.ts:1277
completeNodeOptions
Get Signature
get completeNodeOptions():
object
Returns
object
alpha?
optional
alpha:number
Opacity of the node. 0 is fully transparent, 1 is fully opaque. Default is 1.0. Alpha has multiplicative inheritance. For example, if the node's parent is alpha .5 and this node's is alpha .4, then the node will appear with alpha .2.
anchorPoint?
optional
anchorPoint:Point
Point within the node that determines its position. Default is { x: 0.5, y: 0.5 }, which centers the node on its position
backgroundColor
backgroundColor:
undefined
|RgbaColor
draggable?
optional
draggable:boolean
Can the node be dragged?
fontColor?
optional
fontColor:RgbaColor
Color of text. Default is Constants.DEFAULT_FONT_COLOR (WebColors.Black)
fontName?
optional
fontName:string
Name of font to use for text. Must have been previously loaded
fontNames
fontNames:
undefined
|string
[]
fontSize?
optional
fontSize:number
Size of text. Default is Constants.DEFAULT_FONT_SIZE (16)
hidden?
optional
hidden:boolean
Is the node, and its children, hidden? (not displayed). Default is false
horizontalAlignmentMode
horizontalAlignmentMode:
LabelHorizontalAlignmentMode
interpolation?
optional
interpolation:StringInterpolationMap
Map of placeholders to values for use in string interpolation during localization.
isUserInteractionEnabled?
optional
isUserInteractionEnabled:boolean
Does the node respond to user events, such as taps? Default is false
layout?
optional
layout:Layout
FOR INTERNAL USE ONLY
localize?
optional
localize:boolean
If true, try to use a localized version of the text. Default is true.
name?
optional
name:string
Name of the node. Only needed if the node will be referred to by name in a later function
position?
optional
position:Point
Position of the node within its parent coordinate system. Default is (0, 0)
preferredMaxLayoutWidth
preferredMaxLayoutWidth:
undefined
|number
scale?
optional
scale:number
Scale of the node. Default is 1.0
suppressEvents?
optional
suppressEvents:boolean
Should the node not emit events to the EventStore? Default is false.
Remarks
This property is for use by authors of Composite
nodes. It is not intended for general use.
text?
optional
text:string
Text to be displayed
uuid?
optional
uuid:string
Internal
Unique identifier (UUID). Will be generated automatically. For m2c2kit library use only
zPosition?
optional
zPosition:number
Value along the z-axis to determine drawing and tap order. Larger values are on top.
zRotation?
optional
zRotation:number
Rotation of the node around the Z axis. Unit is radians. Default is 0 (no rotation). zRotation has inheritance. In addition to this node's zRotation, all ancestors' zRotations will be applied.
Overrides
Defined in
Label.ts:80
descendants
Get Signature
get descendants():
M2Node
[]
Returns all descendant nodes.
Remarks
Descendants are children and children of children, recursively.
Returns
M2Node
[]
Inherited from
Defined in
M2Node.ts:524
draggable
Get Signature
get draggable():
boolean
Can the node be dragged?
Returns
boolean
Set Signature
set draggable(
draggable
):void
Can the node be dragged?
Parameters
• draggable: boolean
Returns
void
Can the node be dragged?
Implementation of
Inherited from
Defined in
M2Node.ts:1419
fontColor
Get Signature
get fontColor():
RgbaColor
Color of text. Default is Constants.DEFAULT_FONT_COLOR (WebColors.Black)
Returns
Set Signature
set fontColor(
fontColor
):void
Color of text. Default is Constants.DEFAULT_FONT_COLOR (WebColors.Black)
Parameters
• fontColor: RgbaColor
Returns
void
Color of text. Default is Constants.DEFAULT_FONT_COLOR (WebColors.Black)
Implementation of
Defined in
Label.ts:393
fontName
Get Signature
get fontName():
undefined
|string
Name of font to use for text. Must have been previously loaded
Returns
undefined
| string
Set Signature
set fontName(
fontName
):void
Name of font to use for text. Must have been previously loaded
Parameters
• fontName: undefined
| string
Returns
void
Name of font to use for text. Must have been previously loaded
Implementation of
Defined in
Label.ts:369
fontNames
Get Signature
get fontNames():
undefined
|string
[]
Names of multiple fonts to use for text. For example, if a text font and an emoji font are to be used together. Must have been previously loaded
Returns
undefined
| string
[]
Set Signature
set fontNames(
fontNames
):void
Names of multiple fonts to use for text. For example, if a text font and an emoji font are to be used together. Must have been previously loaded
Parameters
• fontNames: undefined
| string
[]
Returns
void
Names of multiple fonts to use for text. For example, if a text font and an emoji font are to be used together. Must have been previously loaded
Implementation of
Defined in
Label.ts:381
fontSize
Get Signature
get fontSize():
number
Size of text. Default is Constants.DEFAULT_FONT_SIZE (16)
Returns
number
Set Signature
set fontSize(
fontSize
):void
Size of text. Default is Constants.DEFAULT_FONT_SIZE (16)
Parameters
• fontSize: number
Returns
void
Size of text. Default is Constants.DEFAULT_FONT_SIZE (16)
Implementation of
Defined in
Label.ts:405
game
Get Signature
get game():
Game
The game which this node is a part of.
Remarks
Throws error if node is not part of the game object.
Returns
Inherited from
Defined in
M2Node.ts:277
hidden
Get Signature
get hidden():
boolean
Is the node, and its children, hidden? (not displayed). Default is false
Returns
boolean
Set Signature
set hidden(
hidden
):void
Is the node, and its children, hidden? (not displayed). Default is false
Parameters
• hidden: boolean
Returns
void
Is the node, and its children, hidden? (not displayed). Default is false
Implementation of
Inherited from
Defined in
M2Node.ts:1408
horizontalAlignmentMode
Get Signature
get horizontalAlignmentMode():
LabelHorizontalAlignmentMode
Horizontal alignment of label text. see LabelHorizontalAlignmentMode. Default is LabelHorizontalAlignmentMode.center
Returns
Set Signature
set horizontalAlignmentMode(
horizontalAlignmentMode
):void
Horizontal alignment of label text. see LabelHorizontalAlignmentMode. Default is LabelHorizontalAlignmentMode.center
Parameters
• horizontalAlignmentMode: LabelHorizontalAlignmentMode
Returns
void
Horizontal alignment of label text. see LabelHorizontalAlignmentMode. Default is LabelHorizontalAlignmentMode.center
Implementation of
LabelOptions
.horizontalAlignmentMode
Defined in
Label.ts:417
interpolation
Get Signature
get interpolation():
StringInterpolationMap
Map of placeholders to values for use in string interpolation during localization.
Returns
Set Signature
set interpolation(
interpolation
):void
Map of placeholders to values for use in string interpolation during localization.
Parameters
• interpolation: StringInterpolationMap
Returns
void
Map of placeholders to values for use in string interpolation during localization.
Implementation of
Defined in
Label.ts:348
isUserInteractionEnabled
Get Signature
get isUserInteractionEnabled():
boolean
Does the node respond to user events, such as taps? Default is false
Returns
boolean
Set Signature
set isUserInteractionEnabled(
isUserInteractionEnabled
):void
Does the node respond to user events, such as taps? Default is false
Parameters
• isUserInteractionEnabled: boolean
Returns
void
Does the node respond to user events, such as taps? Default is false
Implementation of
LabelOptions
.isUserInteractionEnabled
Inherited from
M2Node
.isUserInteractionEnabled
Defined in
M2Node.ts:1394
localize
Get Signature
get localize():
boolean
If true, try to use a localized version of the text. Default is true.
Returns
boolean
Set Signature
set localize(
localize
):void
If true, try to use a localized version of the text. Default is true.
Parameters
• localize: boolean
Returns
void
If true, try to use a localized version of the text. Default is true.
Implementation of
Defined in
Label.ts:461
parentSceneAsNode
Get Signature
get parentSceneAsNode():
M2Node
Returns
Inherited from
Defined in
M2Node.ts:1281
position
Get Signature
get position():
Point
Position of the node within its parent coordinate system. Default is (0, 0)
Returns
Set Signature
set position(
position
):void
Position of the node within its parent coordinate system. Default is (0, 0)
Parameters
• position: Point
Returns
void
Position of the node within its parent coordinate system. Default is (0, 0)
Implementation of
Inherited from
Defined in
M2Node.ts:1327
preferredMaxLayoutWidth
Get Signature
get preferredMaxLayoutWidth():
undefined
|number
Maximum width of label text before wrapping occurs. Default is the canvas width
Returns
undefined
| number
Set Signature
set preferredMaxLayoutWidth(
preferredMaxLayoutWidth
):void
Maximum width of label text before wrapping occurs. Default is the canvas width
Parameters
• preferredMaxLayoutWidth: undefined
| number
Returns
void
Maximum width of label text before wrapping occurs. Default is the canvas width
Implementation of
LabelOptions
.preferredMaxLayoutWidth
Defined in
Label.ts:434
scale
Get Signature
get scale():
number
Scale of the node. Default is 1.0
Returns
number
Set Signature
set scale(
scale
):void
Scale of the node. Default is 1.0
Parameters
• scale: number
Returns
void
Scale of the node. Default is 1.0
Implementation of
Inherited from
Defined in
M2Node.ts:1372
size
Get Signature
get size():
Size
Returns
Set Signature
set size(
size
):void
Parameters
• size: Size
Returns
void
Inherited from
Defined in
M2Node.ts:1293
suppressEvents
Get Signature
get suppressEvents():
boolean
Should the node not emit events to the EventStore? Default is false.
Remarks
This property is for use by authors of Composite
nodes. It is not intended for general use.
Returns
boolean
Set Signature
set suppressEvents(
value
):void
Should the node not emit events to the EventStore? Default is false.
Remarks
This property is for use by authors of Composite
nodes. It is not intended for general use.
Parameters
• value: boolean
Returns
void
Should the node not emit events to the EventStore? Default is false.
Remarks
This property is for use by authors of Composite
nodes. It is not intended for general use.
Implementation of
Inherited from
Defined in
M2Node.ts:1430
text
Get Signature
get text():
string
Text to be displayed
Returns
string
Set Signature
set text(
text
):void
Text to be displayed
Parameters
• text: string
Returns
void
Text to be displayed
Implementation of
Defined in
Label.ts:336
zPosition
Get Signature
get zPosition():
number
Value along the z-axis to determine drawing and tap order. Larger values are on top.
Returns
number