Class KeyControl | Input System | 1.0.2
docs.unity3d.com
    Show / Hide Table of Contents

    Class KeyControl

    A key on a Keyboard.

    Inheritance
    Object
    InputControl
    InputControl<Single>
    AxisControl
    ButtonControl
    KeyControl
    Inherited Members
    ButtonControl.pressPoint
    ButtonControl.pressPointOrDefault
    ButtonControl.IsValueConsideredPressed(Single)
    ButtonControl.isPressed
    ButtonControl.wasPressedThisFrame
    ButtonControl.wasReleasedThisFrame
    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.FinishSetup()
    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.RefreshConfigurationIfNeeded()
    InputControl.m_StateBlock
    InputControl.currentStatePtr
    InputControl.previousFrameStatePtr
    InputControl.defaultStatePtr
    InputControl.noiseMaskPtr
    InputControl.stateOffsetRelativeToDeviceRoot
    Namespace: UnityEngine.InputSystem.Controls
    Syntax
    [Preserve]
    public class KeyControl : ButtonControl
    Remarks

    This is an extended button control which adds various features to account for the fact that keys have symbols associated with them which may change depending on keyboard layout as well as in combination with other keys.

    Note that there is no text input associated with individual keys as text composition is highly layout specific and does not need to be key-by-key. For general text input, see onTextInput. To find the text displayed on a key, use .

    Properties

    keyCode

    The code used in Unity to identify the key.

    Declaration
    public Key keyCode { get; set; }
    Property Value
    Type Description
    Key
    Remarks

    This property must be initialized by FinishSetup() of the device owning the control.

    scanCode

    The code that the underlying platform uses to identify the key.

    Declaration
    public int scanCode { get; }
    Property Value
    Type Description
    Int32

    Methods

    RefreshConfiguration()

    Declaration
    protected override void RefreshConfiguration()
    Overrides
    InputControl.RefreshConfiguration()

    Extension Methods

    InputControlExtensions.FindInParentChain<TControl>(InputControl)
    InputControlExtensions.IsPressed(InputControl, Single)
    InputControlExtensions.IsActuated(InputControl, Single)
    InputControlExtensions.ReadValueAsObject(InputControl)
    InputControlExtensions.ReadValueIntoBuffer(InputControl, Void*, Int32)
    InputControlExtensions.ReadDefaultValueAsObject(InputControl)
    InputControlExtensions.ReadValueFromEvent<TValue>(InputControl<TValue>, InputEventPtr)
    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.AccumulateValueInEvent(InputControl<Single>, Void*, InputEventPtr)
    InputControlExtensions.FindControlsRecursive<TControl>(InputControl, IList<TControl>, Func<TControl, Boolean>)
    In This Article
    • Properties
      • keyCode
      • scanCode
    • Methods
      • RefreshConfiguration()
    • Extension Methods
    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