Version: 2023.2
LanguageEnglish
  • C#

UIToolkitInputConfiguration.SetRuntimeInputBackend

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public static void SetRuntimeInputBackend(UIElements.UIToolkitInputBackendOption backend);

Parameters

backend The input backend to be used as the source of input for UI Toolkit events at runtime.

Description

Use this method to activate one of the two input backends available for UIToolkit events at runtime. The new Input System compatible backend allows the Input System package to send its input to UI Toolkit directly, removing the need for an UnityEngine.EventSystems.EventSystem in the user scene, and will automatically fall back to Input Manager input if the Input System package input isn't enabled in the Player Settings active input handling. Alternatively, use the legacy backend to always rely on Input Manager input only. In that case, if the Input Manager is not enabled as an active input handler, UI Toolkit runtime events will not work.

The Input System compatible backend is enabled by default. Call this method to disable it or to enable it again if it was otherwise disabled.

Setting the runtime input backend has no impact on Editor-only content such as EditorWindows or custom inspectors.

This method has no effect if there is an UnityEngine.EventSystems.EventSystem in the user scene. In that case, UI Toolkit runtime events will be provided by that EventSystem for as long as it remains enabled.