MainToolbarToggle
Describes the content and behaviour of a toggle element for the main toolbar.
Read time 2 minutesLast updated 6 days ago
Definition
- Type: Class
- Namespace: UnityEditor.Toolbars
- Assembly: UnityEditor
- Inherits from: MainToolbarElement
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. |