API reference
API reference
Select your platform
No SDKs available
No versions available

ButtonReleaseEventArgs Class

Extends EventArgs
Modifiers: final
Event arguments for button release events.
ButtonReleaseEventArgs is used to pass information about a button release interaction through the event system. It contains a HitInfo object that provides details about the interaction, such as the hit point, normal, and distance, as well as the specific ControllerButton that was released.
This class is typically used when registering event listeners for button release events on entities, allowing components to respond to specific button release inputs.
Example usage:
// Register a button release event listener on an entity
entity.registerEventListener<ButtonReleaseEventArgs>(ButtonReleaseEventArgs.EVENT_NAME) { entity, eventArgs ->
    // Handle the button release event
    val hitPoint = eventArgs.hitInfo.hitPoint
    val button = eventArgs.button
    // Perform actions based on which button was released
    when (button) {
        ControllerButton.A -> handleAButtonRelease()
        ControllerButton.LeftTrigger -> handleLeftTriggerRelease()
        // Handle other buttons...
    }
}

Signature

class ButtonReleaseEventArgs(val hitInfo: HitInfo, val button: ControllerButton, val dataModel: DataModel) : EventArgs

Constructors

ButtonReleaseEventArgs ( hitInfo , button , dataModel )
Signature
constructor(hitInfo: HitInfo, button: ControllerButton, dataModel: DataModel)
Parameters
hitInfo: HitInfo
  Information about the hit/interaction that triggered the button release
  The specific controller button that was released
dataModel: DataModel
  The data model associated with this event

Properties

[Get]
The specific controller button that was released
Signature
val button: ControllerButton
dataModel : DataModel
[Get]
Signature
val dataModel: DataModel
eventName : String
[Get]
Signature
val eventName: String
handled : Boolean
[Get][Set]
Signature
var handled: Boolean
hitInfo : HitInfo
[Get]
Information about the hit/interaction that triggered the button release
Signature
val hitInfo: HitInfo
throttleTime : Int?
[Get][Set]
Signature
var throttleTime: Int?

Companion Object

Companion Object Properties

EVENT_NAME : String
[Get]
The name of the button release event, used when registering event listeners.
Signature
const val EVENT_NAME: String

Companion Object Functions

fromHitInfo ( hitInfo , dataModel , changed )
Creates a ButtonReleaseEventArgs instance from a HitInfo object, DataModel, and button identifier.
This factory method provides a convenient way to create ButtonReleaseEventArgs instances when sending events. It maps the raw button identifier (from ButtonBits) to the corresponding ControllerButton enum value.
Signature
fun fromHitInfo(hitInfo: HitInfo, dataModel: DataModel, changed: Int): ButtonReleaseEventArgs
Parameters
hitInfo: HitInfo
  Information about the hit/interaction that triggered the button release
dataModel: DataModel
  The data model associated with this event
changed: Int
  The raw button identifier (from ButtonBits) that was released
Returns
  A new ButtonReleaseEventArgs instance
Did you find this page helpful?