Class ButtonControl | Package Manager UI website
docs.unity3d.com
    Show / Hide Table of Contents

    Class ButtonControl

    An axis that has a trigger point beyond which it is considered to be pressed.

    Inheritance
    System.Object
    InputControl
    InputControl<System.Single>
    AxisControl
    ButtonControl
    AnyKeyControl
    DiscreteButtonControl
    KeyControl
    TouchPressControl
    Inherited Members
    AxisControl.clamp
    AxisControl.clampMin
    AxisControl.clampMax
    AxisControl.clampConstant
    AxisControl.invert
    AxisControl.normalize
    AxisControl.normalizeMin
    AxisControl.normalizeMax
    AxisControl.normalizeZero
    AxisControl.scale
    AxisControl.scaleFactor
    AxisControl.Preprocess(Single)
    AxisControl.ReadUnprocessedValueFromState(Void*)
    AxisControl.WriteValueIntoState(Single, Void*)
    AxisControl.CompareValue(Void*, Void*)
    AxisControl.EvaluateMagnitude(Void*)
    InputControl<Single>.valueType
    InputControl<Single>.valueSizeInBytes
    InputControl<Single>.ReadValue()
    InputControl<Single>.ReadValueFromPreviousFrame()
    InputControl<Single>.ReadDefaultValue()
    InputControl<Single>.ReadValueFromState(Void*)
    InputControl<Single>.ReadUnprocessedValue()
    InputControl<Single>.ReadValueFromStateAsObject(Void*)
    InputControl<Single>.ReadValueFromStateIntoBuffer(Void*, Void*, Int32)
    InputControl<Single>.WriteValueFromBufferIntoState(Void*, Int32, Void*)
    InputControl<Single>.WriteValueFromObjectIntoState(Object, Void*)
    InputControl<Single>.ReadValueFromBufferAsObject(Void*, Int32)
    InputControl<Single>.ProcessValue(Single)
    InputControl.name
    InputControl.displayName
    InputControl.shortDisplayName
    InputControl.path
    InputControl.layout
    InputControl.variants
    InputControl.device
    InputControl.parent
    InputControl.children
    InputControl.usages
    InputControl.aliases
    InputControl.stateBlock
    InputControl.noisy
    InputControl.synthetic
    InputControl.Item[String]
    InputControl.ToString()
    InputControl.EvaluateMagnitude()
    InputControl.TryGetChildControl(String)
    InputControl.TryGetChildControl<TControl>(String)
    InputControl.GetChildControl(String)
    InputControl.GetChildControl<TControl>(String)
    InputControl.FinishSetup()
    InputControl.RefreshConfigurationIfNeeded()
    InputControl.RefreshConfiguration()
    InputControl.m_StateBlock
    InputControl.currentStatePtr
    InputControl.previousFrameStatePtr
    InputControl.defaultStatePtr
    InputControl.noiseMaskPtr
    InputControl.stateOffsetRelativeToDeviceRoot
    Namespace: UnityEngine.InputSystem.Controls
    Syntax
    public class ButtonControl : AxisControl
    Remarks

    By default stored as a single bit. In that format, buttons will only yield 0 and 1 as values.

    It may seem unnatural to derive ButtonControl from AxisControl, but doing so brings many benefits through allowing code to flexibly target buttons and axes the same way.

    Constructors

    ButtonControl()

    Declaration
    public ButtonControl()

    Fields

    pressPoint

    Declaration
    public float pressPoint
    Field Value
    Type Description
    System.Single

    Properties

    isPressed

    Declaration
    public bool isPressed { get; }
    Property Value
    Type Description
    System.Boolean

    pressPointOrDefault

    Declaration
    public float pressPointOrDefault { get; }
    Property Value
    Type Description
    System.Single

    wasPressedThisFrame

    Declaration
    public bool wasPressedThisFrame { get; }
    Property Value
    Type Description
    System.Boolean

    wasReleasedThisFrame

    Declaration
    public bool wasReleasedThisFrame { get; }
    Property Value
    Type Description
    System.Boolean

    Methods

    IsValueConsideredPressed(Single)

    Declaration
    public bool IsValueConsideredPressed(float value)
    Parameters
    Type Name Description
    System.Single value
    Returns
    Type Description
    System.Boolean

    Extension Methods

    InputControlExtensions.IsActuated(InputControl, Single)
    InputControlExtensions.ReadValueAsObject(InputControl)
    InputControlExtensions.ReadValueIntoBuffer(InputControl, Void*, Int32)
    InputControlExtensions.ReadDefaultValueAsObject(InputControl)
    InputControlExtensions.ReadValueFromEvent<TValue>(InputControl<TValue>, InputEventPtr, out TValue)
    InputControlExtensions.ReadUnprocessedValueFromEvent<TValue>(InputControl<TValue>, InputEventPtr)
    InputControlExtensions.ReadUnprocessedValueFromEvent<TValue>(InputControl<TValue>, InputEventPtr, out TValue)
    InputControlExtensions.WriteValueFromObjectIntoEvent(InputControl, InputEventPtr, Object)
    InputControlExtensions.WriteValueIntoState(InputControl, Void*)
    InputControlExtensions.WriteValueIntoState<TValue>(InputControl, TValue, Void*)
    InputControlExtensions.WriteValueIntoState<TValue>(InputControl<TValue>, TValue, Void*)
    InputControlExtensions.WriteValueIntoState<TValue>(InputControl<TValue>, Void*)
    InputControlExtensions.WriteValueIntoState<TValue, TState>(InputControl<TValue>, TValue, ref TState)
    InputControlExtensions.WriteValueIntoEvent<TValue>(InputControl, TValue, InputEventPtr)
    InputControlExtensions.WriteValueIntoEvent<TValue>(InputControl<TValue>, TValue, InputEventPtr)
    InputControlExtensions.CheckStateIsAtDefault(InputControl)
    InputControlExtensions.CheckStateIsAtDefault(InputControl, Void*, Void*)
    InputControlExtensions.CheckStateIsAtDefaultIgnoringNoise(InputControl)
    InputControlExtensions.CheckStateIsAtDefaultIgnoringNoise(InputControl, Void*)
    InputControlExtensions.CompareStateIgnoringNoise(InputControl, Void*)
    InputControlExtensions.CompareState(InputControl, Void*, Void*, Void*)
    InputControlExtensions.CompareState(InputControl, Void*, Void*)
    InputControlExtensions.HasValueChangeInState(InputControl, Void*)
    InputControlExtensions.HasValueChangeInEvent(InputControl, InputEventPtr)
    InputControlExtensions.GetStatePtrFromStateEvent(InputControl, InputEventPtr)
    InputControlExtensions.QueueValueChange<TValue>(InputControl<TValue>, TValue, Double)
    InputControlExtensions.FindControlsRecursive<TControl>(InputControl, IList<TControl>, Func<TControl, Boolean>)
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023