Class InputControlLayoutAttribute

Attribute to control layout settings of a type used to generate an InputControlLayout.

Inheritance
Object
InputControlLayoutAttribute
Namespace: UnityEngine.InputSystem.Layouts
Syntax
public sealed class InputControlLayoutAttribute : Attribute

Properties

canRunInBackground

Declaration
public bool canRunInBackground { get; set; }
Property Value
Type Description
Boolean

commonUsages

Declaration
public string[] commonUsages { get; set; }
Property Value
Type Description
String[]

description

Declaration
public string description { get; set; }
Property Value
Type Description
String

displayName

Gives a name to display in the UI. By default, the name is the same as the class the attribute is applied to.

Declaration
public string displayName { get; set; }
Property Value
Type Description
String

hideInUI

If true, don't include the layout when presenting picking options in the UI.

Declaration
public bool hideInUI { get; set; }
Property Value
Type Description
Boolean
Remarks

This will keep device layouts out of the control picker and will keep control layouts out of action type dropdowns.

isGenericTypeOfDevice

If true, the layout describes a generic class of devices such as "gamepads" or "mice".

Declaration
public bool isGenericTypeOfDevice { get; set; }
Property Value
Type Description
Boolean
Remarks

This property also determines how the layout is presented in the UI. All the device layouts that are marked as generic kinds of devices are displayed with their own entry at the root level of the control picker (InputControlPicker), for example.

stateFormat

FourCC identifier for the memory format associated with the layout.

Declaration
public string stateFormat { get; set; }
Property Value
Type Description
String
See Also

stateType

Associates a state representation with an input device and drives the control layout generated for the device from its state rather than from the device class.

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

This is only useful if you have a state struct dictating a specific state layout and you want the device layout to automatically take offsets from the fields annotated with InputControlAttribute.

public struct MyStateStruct : IInputStateTypeInfo
{
    public FourCC format => new FourCC('M', 'Y', 'D', 'V');

    [InputControl(name = "button1", layout = "Button", bit = 0)]
    [InputControl(name = "button2", layout = "Button", bit = 0)]
    public int buttons;
}

[InputControlLayout(stateType = typeof(MyStateStruct)]
public class MyDevice : InputDevice
{
}
See Also

updateBeforeRender

Whether the device should receive events in BeforeRender updates.

Declaration
public bool updateBeforeRender { get; set; }
Property Value
Type Description
Boolean
See Also

variants

Declaration
public string variants { get; set; }
Property Value
Type Description
String