The Button Events node takes in a global IButton reference and will listen for events from that global reference. When it detects something happening, it will fire events depending on what happens, along with other data.
You can use this node with UI Buttons, Touch Buttons, Physical Buttons, Context Menu Buttons, or even a custom button you add as a component onto a Slot or object, like a box.
Outputs
Pressed (Call)
Sends an Impulse when the button in Global: IButton is pressed down
Pressing (Call)
Sends an Impulse every game update while the button in Global: IButton is being held down
Released (Call)
Sends an Impulse when the button in Global: IButton is released
HoverEnter (Call)
Sends an Impulse a cursor/laser is brought on top of the button in Global: IButton (TODO: Does this include touching? (Ex: Physical buttons))
HoverStay (Call)
Sends an Impulse every game update while the button in Global: IButton is being currently being hovered over (TODO: Does this include touching? (Ex: Physical buttons))
HoverLeave (Call)
Sends an Impulse a cursor/laser leaves being on top of the button in Global: IButton (TODO: Does this include touching? (Ex: Physical buttons))
Source (Component)
The source of the button press.
When using the laser on the button, this returns with RelayTouchSource.
When physically pressing the button, this returns with TipTouchSource.
GlobalPoint (float3)
The point in global transform in the world the user's cursor is at on the surface of the button during any of this node's Impulses Example: Useful for a splash of particles where the user clicked like a click effect Also see: Coordinate spaces
LocalPoint (float3)
The point in UIX pixels within the button's local RectTransform the user's cursor is at during any of this node's Impulses Also see: Coordinate spaces
NormalizedPoint (float2)
The point from 0 to 1 in both the x and y channels within the button's local RectTransform the user's cursor is at during any of this node's Impulses. Also see: Coordinate spaces
Globals
Button (IButton)
IButton to read events from.
Examples
-
Button Events being used to make a sound play.