| uid | input-system-screen-button-control |
|---|
To create an on-screen button:
- Add a UI
Buttonobject. - Add the
OnScreenButtoncomponent to it. - Set the controlPath to refer to a
ButtonControl(for example,<Gamepad>/buttonSouth). The type of device referenced by the control path determines the type of virtual device created by the component.
The OnScreenButton component requires the target control to be a Button control. OnScreenButton sets the target control value to 1 when it receives a pointer-down (IPointerDownHandler.OnPointerDown) event, or 0 when it receives a pointer-up (IPointerUpHandler.OnPointerUp) event.
![The OnScreenButton component displays the Control Path value as rightShoulder [Gamepad].](/Unity-Technologies/InputSystem/raw/bf06b577a5efd69ac82155bef5c8bc328f1bf64b/Packages/com.unity.inputsystem/Documentation%7E/Images/OnScreenButton.png)