Class: Button
Extends
Composite
Implements
IText
ButtonOptions
Constructors
new Button()
new Button(
options
):Button
A simple button of rectangle with text centered inside.
Parameters
• options: ButtonOptions
Returns
Remarks
This composite node is composed of a rectangle and text. To respond to user taps, the isUserInteractionEnabled property must be set to true and an appropriate callback must be set to handle the tap event.
Overrides
Composite.constructor
Defined in
m2c2kit/packages/addons/src/composites/button.ts:62
Properties
_alpha
_alpha:
number
Inherited from
Composite._alpha
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2548
_draggable
protected
_draggable:boolean
Inherited from
Composite._draggable
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2551
_game?
optional
_game:Game
Inherited from
Composite._game
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2554
_hidden
protected
_hidden:boolean
Inherited from
Composite._hidden
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2552
_isUserInteractionEnabled
protected
_isUserInteractionEnabled:boolean
Inherited from
Composite._isUserInteractionEnabled
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2550
_position
_position:
Point
Inherited from
Composite._position
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2546
_scale
_scale:
number
Inherited from
Composite._scale
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2547
_size
protected
_size:Size
Inherited from
Composite._size
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2558
_zRotation
_zRotation:
number
Inherited from
Composite._zRotation
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2549
absoluteAlpha
absoluteAlpha:
number
Inherited from
Composite.absoluteAlpha
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2560
absoluteAlphaChange
absoluteAlphaChange:
number
Inherited from
Composite.absoluteAlphaChange
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2561
absolutePosition
absolutePosition:
Point
Inherited from
Composite.absolutePosition
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2557
absoluteScale
absoluteScale:
number
Inherited from
Composite.absoluteScale
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2559
actions
actions:
Action
[]
Inherited from
Composite.actions
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2562
children
children:
M2Node
[]
Inherited from
Composite.children
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2556
compositeType
compositeType:
string
="Button"
Overrides
Composite.compositeType
Defined in
m2c2kit/packages/addons/src/composites/button.ts:37
constructionIso8601TimeStamp
constructionIso8601TimeStamp:
string
Inherited from
Composite.constructionIso8601TimeStamp
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2543
constructionSequence
constructionSequence:
number
Inherited from
Composite.constructionSequence
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2544
constructionTimeStamp
constructionTimeStamp:
number
Inherited from
Composite.constructionTimeStamp
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2542
dragging
dragging:
boolean
Is the node in a dragging state?
Inherited from
Composite.dragging
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2587
draggingLastPointerOffset
draggingLastPointerOffset:
Point
What was the previous pointer offset when the node was in a dragging state?
Inherited from
Composite.draggingLastPointerOffset
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2585
eventListeners
eventListeners:
M2NodeEventListener
<M2NodeEvent
>[]
Inherited from
Composite.eventListeners
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2564
isDrawable
isDrawable:
boolean
Inherited from
Composite.isDrawable
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:124
isShape
isShape:
boolean
Inherited from
Composite.isShape
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2538
isText
isText:
boolean
=true
Overrides
Composite.isText
Defined in
m2c2kit/packages/addons/src/composites/button.ts:38
layout
layout:
Layout
FOR INTERNAL USE ONLY
Implementation of
Inherited from
Composite.layout
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2553
loopMessages
loopMessages:
Set
<string
>
Inherited from
Composite.loopMessages
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2568
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
Composite.name
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2545
needsInitialization
needsInitialization:
boolean
Inherited from
Composite.needsInitialization
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2566
nodeEvents
nodeEvents:
M2Event
<M2Node
>[]
Inherited from
Composite.nodeEvents
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2569
options
options:
M2NodeOptions
Inherited from
Composite.options
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2541
parent?
optional
parent:M2Node
Inherited from
Composite.parent
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2555
pressed
pressed:
boolean
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
Composite.pressed
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2572
pressedAndWithinHitArea
pressedAndWithinHitArea:
boolean
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
Composite.pressedAndWithinHitArea
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2578
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
Composite.pressedInitialPointerOffset
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2582
queuedAction?
optional
queuedAction:Action
Inherited from
Composite.queuedAction
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2563
toString()
toString: () =>
string
Overrides toString() and returns a human-friendly description of the node.
Returns
string
Remarks
Inspiration from https://stackoverflow.com/a/35361695
Inherited from
Composite.toString
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2629
type
readonly
type:Composite
=M2NodeType.Composite
Inherited from
Composite.type
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:122
userData
userData:
any
Inherited from
Composite.userData
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2567
uuid
readonly
uuid:string
Internal
Unique identifier (UUID). Will be generated automatically. For m2c2kit library use only
Implementation of
Inherited from
Composite.uuid
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2565
withinHitArea
withinHitArea:
boolean
Inherited from
Composite.withinHitArea
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2573
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
Composite.alpha
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2886
ancestors
Get Signature
get ancestors():
M2Node
[]
Returns all ancestor nodes, not including the node itself.
Returns
M2Node
[]
Inherited from
Composite.ancestors
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2684
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
Point
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
Inherited from
Composite.anchorPoint
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:134
backgroundColor
Get Signature
get backgroundColor():
RgbaColor
Background color of button. Default is WebColors.Black
Returns
RgbaColor
Set Signature
set backgroundColor(
backgroundColor
):void
Background color of button. Default is WebColors.Black
Parameters
• backgroundColor: RgbaColor
Returns
void
Background color of button. Default is WebColors.Black
Implementation of
Defined in
m2c2kit/packages/addons/src/composites/button.ts:168
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
Composite.canvasKit
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2876
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:
RgbaColor
cornerRadius
cornerRadius:
number
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
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)
scale?
optional
scale:number
Scale of the node. Default is 1.0
size
size:
Size
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
Composite.completeNodeOptions
Defined in
m2c2kit/packages/addons/src/composites/button.ts:100
cornerRadius
Get Signature
get cornerRadius():
number
Corner radius of button; can be used to make rounded corners. Default is 9
Returns
number
Set Signature
set cornerRadius(
cornerRadius
):void
Corner radius of button; can be used to make rounded corners. Default is 9
Parameters
• cornerRadius: number
Returns
void
Corner radius of button; can be used to make rounded corners. Default is 9
Implementation of
Defined in
m2c2kit/packages/addons/src/composites/button.ts:216
descendants
Get Signature
get descendants():
M2Node
[]
Returns all descendant nodes.
Remarks
Descendants are children and children of children, recursively.
Returns
M2Node
[]
Inherited from
Composite.descendants
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2680
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
Composite.draggable
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2892
fontColor
Get Signature
get fontColor():
RgbaColor
Color of button text. Default is WebColors.White
Returns
RgbaColor
Set Signature
set fontColor(
fontColor
):void
Color of button text. Default is WebColors.White
Parameters
• fontColor: RgbaColor
Returns
void
Color of button text. Default is WebColors.White
Implementation of
Defined in
m2c2kit/packages/addons/src/composites/button.ts:180
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
m2c2kit/packages/addons/src/composites/button.ts:192
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
m2c2kit/packages/addons/src/composites/button.ts:204
fontSize
Get Signature
get fontSize():
number
Size of button text. Default is 20.
Returns
number
Set Signature
set fontSize(
fontSize
):void
Size of button text. Default is 20.
Parameters
• fontSize: number
Returns
void
Size of button text. Default is 20.
Implementation of
Defined in
m2c2kit/packages/addons/src/composites/button.ts:228
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
Game
Inherited from
Composite.game
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2617
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
Composite.hidden
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2890
interpolation
Get Signature
get interpolation():
StringInterpolationMap
Map of placeholders to values for use in string interpolation during localization.
Returns
StringInterpolationMap
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
m2c2kit/packages/addons/src/composites/button.ts:240
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
ButtonOptions
.isUserInteractionEnabled
Inherited from
Composite.isUserInteractionEnabled
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2888
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
m2c2kit/packages/addons/src/composites/button.ts:261
parentSceneAsNode
Get Signature
get parentSceneAsNode():
M2Node
Returns
M2Node
Inherited from
Composite.parentSceneAsNode
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2877
position
Get Signature
get position():
Point
Position of the node within its parent coordinate system. Default is (0, 0)
Returns
Point
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
Composite.position
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2880
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
Composite.scale
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2884
size
Get Signature
get size():
Size
Size of button. Default is 200 wide by 50 high.
Returns
Size
Set Signature
set size(
size
):void
Size of button. Default is 200 wide by 50 high.
Parameters
• size: Size
Returns
void
Size of button. Default is 200 wide by 50 high.
Implementation of
Inherited from
Composite.size
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2878
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
Composite.suppressEvents
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2894
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
m2c2kit/packages/addons/src/composites/button.ts:156
zPosition
Get Signature
get zPosition():
number
Value along the z-axis to determine drawing and tap order. Larger values are on top.
Returns
number
Set Signature
set zPosition(
zPosition
):void
Value along the z-axis to determine drawing and tap order. Larger values are on top.
Parameters
• zPosition: number
Returns
void
Value along the z-axis to determine drawing and tap order. Larger values are on top.
Implementation of
Inherited from
Composite.zPosition
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:136
zRotation
Get Signature
get 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.
Returns
number
Set Signature
set zRotation(
zRotation
):void
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.
Parameters
• zRotation: number
Returns
void
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.
Implementation of
Inherited from
Composite.zRotation
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2882
Methods
addChild()
addChild(
child
):void
Adds a child to this parent node. Throws exception if the child's name is not unique with respect to other children of this parent, or if the child has already been added to another parent.
Parameters
• child: M2Node
The child node to add
Returns
void
Inherited from
Composite.addChild
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2637
addEventListener()
addEventListener<
T
>(type
,callback
,callbackOptions
?):void
Type Parameters
• T extends M2NodeEvent
Parameters
• type: string
• callback
• callbackOptions?: CallbackOptions
Returns
void
Inherited from
Composite.addEventListener
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2809
descendant()
descendant<
T
>(name
):T
Searches all descendants by name and returns first matching node.
Type Parameters
• T extends M2Node
Parameters
• name: string
Name of the descendant node to return
Returns
T
Remarks
Descendants are children and children of children, recursively. Throws exception if no descendant with the given name is found.
Inherited from
Composite.descendant
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2674
dispose()
dispose():
void
Returns
void
Overrides
Composite.dispose
Defined in
m2c2kit/packages/addons/src/composites/button.ts:152
draw()
draw(
canvas
):void
Parameters
• canvas: Canvas
Returns
void
Overrides
Composite.draw
Defined in
m2c2kit/packages/addons/src/composites/button.ts:314
drawChildren()
drawChildren(
canvas
):void
Draws each child node that is Drawable and is not hidden, by zPosition order (highest zPosition on top).
Parameters
• canvas: Canvas
CanvasKit canvas
Returns
void
Inherited from
Composite.drawChildren
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2831
duplicate()
duplicate(
newName
?):Button
Duplicates a node using deep copy.
Parameters
• newName?: string
optional name of the new, duplicated node. If not provided, name will be the new uuid
Returns
Remarks
This is a deep recursive clone (node and children). The uuid property of all duplicated nodes will be newly created, because uuid must be unique.
Overrides
Composite.duplicate
Defined in
m2c2kit/packages/addons/src/composites/button.ts:283
getDrawableOptions()
protected
getDrawableOptions():DrawableOptions
Returns
DrawableOptions
Inherited from
Composite.getDrawableOptions
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2869
getNodeOptions()
protected
getNodeOptions():M2NodeOptions
Returns
M2NodeOptions
Inherited from
Composite.getNodeOptions
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2868
getTextOptions()
protected
getTextOptions():TextOptions
Returns
TextOptions
Inherited from
Composite.getTextOptions
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2870
handleCompositeEvent()
handleCompositeEvent(
event
):void
Event handler for custom events a Composite
may generate.
Parameters
• event: CompositeEvent
event to handle
Returns
void
Remarks
If the Composite
generates custom events, this method is
necessary for the Composite
to work in replay mode.
Inherited from
Composite.handleCompositeEvent
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:150
initialize()
initialize():
void
Returns
void
Overrides
Composite.initialize
Defined in
m2c2kit/packages/addons/src/composites/button.ts:113
involvedInActionAffectingAppearance()
involvedInActionAffectingAppearance():
boolean
Determines if this node or ancestor is part of an active action that affects it appearance.
Returns
boolean
true if part of active action affecting appearance
Remarks
This is used to determine if the node should be rendered with anti-aliasing or not. Anti-aliasing on some devices causes a new shader to be compiled during the action, which causes jank.
Inherited from
Composite.involvedInActionAffectingAppearance
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2695
involvedInSceneTransition()
involvedInSceneTransition():
boolean
Determines if the node is a transitioning Scene or a descendant of a transitioning Scene.
Returns
boolean
true if transitioning
Inherited from
Composite.involvedInSceneTransition
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2702
onDrag()
onDrag(
callback
,options
?):void
Executes a callback when the user continues dragging a node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Inherited from
Composite.onDrag
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2801
onDragEnd()
onDragEnd(
callback
,options
?):void
Executes a callback when the user stop dragging a node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Inherited from
Composite.onDragEnd
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2808
onDragStart()
onDragStart(
callback
,options
?):void
Executes a callback when the user begins dragging a node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Inherited from
Composite.onDragStart
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2794
onPointerDown()
onPointerDown(
callback
,options
?):void
Executes a callback when the pointer first is down on the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Remarks
PointerDown is a pointer down (mouse click or touches begin) within the bounds of the node. It occurs under the same conditions as TapDown.
Inherited from
Composite.onPointerDown
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2759
onPointerLeave()
onPointerLeave(
callback
,options
?):void
Executes a callback when the user moves the pointer (mouse or touches) outside the bounds of the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Inherited from
Composite.onPointerLeave
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2787
onPointerMove()
onPointerMove(
callback
,options
?):void
Executes a callback when the user moves the pointer (mouse or touches) within the bounds of the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Inherited from
Composite.onPointerMove
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2779
onPointerUp()
onPointerUp(
callback
,options
?):void
Executes a callback when the user releases a press from the node within the bounds of the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Remarks
PointerUp is a pointer up (mouse click release or touches end) within the bounds of the node. It does not require that there was a previous PointerDown on the node.
Inherited from
Composite.onPointerUp
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2771
onTapDown()
onTapDown(
callback
,options
?):void
Executes a callback when the user presses down on the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Remarks
TapDown is a pointer down (mouse click or touches begin) within the bounds of the node.
Inherited from
Composite.onTapDown
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2712
onTapLeave()
onTapLeave(
callback
,options
?):void
Executes a callback when the user moves the pointer (mouse, touches) beyond the bounds of the node while the pointer is down.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Remarks
TapLeave occurs when the pointer (mouse, touches) that has previously pressed the node moves beyond the bounds of the node before the press release.
Inherited from
Composite.onTapLeave
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2749
onTapUp()
onTapUp(
callback
,options
?):void
Executes a callback when the user releases a press, that has been fully within the node, from the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptionsue.
Returns
void
Remarks
TapUp is a pointer up (mouse click release or touches end) within the bounds of the node and the pointer, while down, has never moved beyond the bounds of the node.
Inherited from
Composite.onTapUp
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2724
onTapUpAny()
onTapUpAny(
callback
,options
?):void
Executes a callback when the user releases a press from the node within the bounds of the node.
Parameters
• callback
function to execute
• options?: CallbackOptions
CallbackOptions
Returns
void
Remarks
TapUpAny is a pointer up (mouse click release or touches end) within the bounds of the node and the pointer, while down, is allowed to have been beyond the bounds of the node during the press before the release.
Inherited from
Composite.onTapUpAny
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2737
removeAction()
removeAction(
key
):void
Remove an action from this node. If the action is running, it will be stopped.
Parameters
• key: string
key (string identifier) of the action to remove
Returns
void
Inherited from
Composite.removeAction
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2851
removeAllActions()
removeAllActions():
void
Remove all actions from this node. If actions are running, they will be stopped.
Returns
void
Inherited from
Composite.removeAllActions
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2856
removeAllChildren()
removeAllChildren():
void
Removes all children from the node.
Returns
void
Inherited from
Composite.removeAllChildren
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2650
removeChild()
removeChild(
child
):void
Removes the specific child from this parent node. Throws exception if this parent does not contain the child.
Parameters
• child: M2Node
Returns
void
Inherited from
Composite.removeChild
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2657
removeChildren()
removeChildren(
children
):void
Removes the children from the parent. Throws error if the parent does not contain all of the children.
Parameters
• children: M2Node
[]
An array of children to remove from the parent node
Returns
void
Inherited from
Composite.removeChildren
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2664
run()
run(
action
,key
?):void
Runs an action on this node.
Parameters
• action: Action
The action to run
• key?: string
key (string identifier) used to identify the action. Only needed if the action will be referred to later
Returns
void
Remarks
If the node is part of an active scene, the action runs immediately. Otherwise, the action will run when the node's scene becomes active. Calling run() multiple times on a node will add to existing actions, not replace them.
Inherited from
Composite.run
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2844
saveEvent()
protected
saveEvent(event
):void
Saves the node's event.
Parameters
• event: M2Event
<M2Node
>
event to save
Returns
void
Remarks
If the game event store is not available, the event is saved
within the node's nodeEvents
event array. It will be added to the game
event store when the node is added to the game.
Inherited from
Composite.saveEvent
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2611
saveNodeNewEvent()
protected
saveNodeNewEvent():void
Save the node's construction event in the event store.
Returns
void
Inherited from
Composite.saveNodeNewEvent
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2594
savePropertyChangeEvent()
protected
savePropertyChangeEvent(property
,value
):void
Saves the node's property change event in the event store.
Parameters
• property: string
property name
• value: undefined
| null
| string
| number
| boolean
| object
property value
Returns
void
Inherited from
Composite.savePropertyChangeEvent
Defined in
node_modules/@m2c2kit/core/dist/index.d.ts:2601
update()
update():
void
Returns
void
Overrides
Composite.update
Defined in
m2c2kit/packages/addons/src/composites/button.ts:310
warmup()
warmup(
canvas
):void
Parameters
• canvas: Canvas
Returns
void
Overrides
Composite.warmup
Defined in
m2c2kit/packages/addons/src/composites/button.ts:318