Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


MainToolbarToggle

Describes the content and behaviour of a toggle element for the main toolbar.
Read time 2 minutesLast updated 6 days ago

Definition

[Icon("UIToolkit/Icons/Toggle.png")]public sealed class MainToolbarToggle : MainToolbarElement

Remarks

To add a toggle element in the main toolbar, return an instance of this class through a static method registered with MainToolbarElementAttribute .

Examples

using UnityEditor;using UnityEditor.Toolbars;using UnityEngine;public class MainToolbarToggleExample{ const string kElementPath = "Examples/Toggle Scene Visibility"; [MainToolbarElement(kElementPath, defaultDockPosition = MainToolbarDockPosition.Middle)] public static MainToolbarElement CreateSceneViewGridToggle() { bool showGrid = SceneView.lastActiveSceneView is not null && SceneView.lastActiveSceneView.showGrid; var onIcon = EditorGUIUtility.IconContent("d_scenevis_visible").image as Texture2D; var offIcon = EditorGUIUtility.IconContent("d_scenevis_hidden").image as Texture2D; // We can change the content based on the internal state we want represented e.g. showGrid var icon = showGrid ? onIcon : offIcon; var content = new MainToolbarContent("Show Grid", icon, "Toggle grid visibility"); return new MainToolbarToggle(content, showGrid, ToggleSceneGrid); } static void ToggleSceneGrid(bool value) { // The MainToolbarToggle does not keep its own state. It notifies this user code via // our ToggleSceneGrid callback, and it is the user's responsibility to update their // internal state and refresh the UI. if (SceneView.lastActiveSceneView is not null) SceneView.lastActiveSceneView.showGrid = value; MainToolbar.Refresh(kElementPath); } static void SceneViewChanged(SceneView oldScene, SceneView newScene) { // Scene grid visibility can be changed elsewhere such as in the Scene view. // If that happens we want to be notified in order to refresh the UI to match. // Since CreateSceneViewGridToggle checks the internal state to match the UI content it produces, // we only need to call MainToolbar.Refresh with the matching path, but we will just use ToggleSceneGrid // for simplicity. if (oldScene != null) oldScene.gridVisibilityChanged -= ToggleSceneGrid; if (newScene != null) newScene.gridVisibilityChanged += ToggleSceneGrid; } static MainToolbarToggleExample() { SceneView.lastActiveSceneViewChanged += SceneViewChanged; }}

Constructors

Constructor

Description

MainToolbarToggle(UnityEditor.Toolbars.MainToolbarContent,System.Boolean,System.Action{System.Boolean})Specify the content and function of a main toolbar toggle.

Inheritance