docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Class ScriptableSettingsProvider<T>

    Expose a ScriptableSettings<T> object as a settings provider.

    Inheritance
    object
    SettingsProvider
    ScriptableSettingsProvider<T>
    Inherited Members
    SettingsProvider.OnDeactivate()
    SettingsProvider.HasSearchInterest(string)
    SettingsProvider.OnTitleBarGUI()
    SettingsProvider.OnFooterBarGUI()
    SettingsProvider.OnInspectorUpdate()
    SettingsProvider.Repaint()
    SettingsProvider.PopulateSearchKeywordsFromGUIContentProperties<T>()
    SettingsProvider.GetSearchKeywordsFromGUIContentProperties<T>()
    SettingsProvider.GetSearchKeywordsFromSerializedObject(SerializedObject)
    SettingsProvider.GetSearchKeywordsFromPath(string)
    SettingsProvider.label
    SettingsProvider.settingsPath
    SettingsProvider.scope
    SettingsProvider.keywords
    SettingsProvider.guiHandler
    SettingsProvider.titleBarGuiHandler
    SettingsProvider.footerBarGuiHandler
    SettingsProvider.activateHandler
    SettingsProvider.deactivateHandler
    SettingsProvider.hasSearchInterestHandler
    SettingsProvider.inspectorUpdateHandler
    object.Equals(object)
    object.Equals(object, object)
    object.GetHashCode()
    object.GetType()
    object.MemberwiseClone()
    object.ReferenceEquals(object, object)
    object.ToString()
    Namespace: Unity.XR.CoreUtils.Editor
    Assembly: Unity.XR.CoreUtils.Editor.dll
    Syntax
    public abstract class ScriptableSettingsProvider<T> : SettingsProvider where T : ScriptableSettingsBase<T>
    Type Parameters
    Name Description
    T

    The ScriptableSettings type to be exposed.

    Constructors

    ScriptableSettingsProvider(string, SettingsScope)

    Initialize a new ScriptableSettingsProvider.

    Declaration
    protected ScriptableSettingsProvider(string path, SettingsScope scope = SettingsScope.User)
    Parameters
    Type Name Description
    string path

    The path to this settings view within the Preferences or Project Settings window.

    SettingsScope scope

    The scope of these settings.

    Properties

    SerializedObject

    A SerializedObject representing the ScriptableSettings being provided.

    Declaration
    protected SerializedObject SerializedObject { get; }
    Property Value
    Type Description
    SerializedObject

    Target

    The ScriptableSettings being provided.

    Declaration
    protected T Target { get; }
    Property Value
    Type Description
    T

    Methods

    OnActivate(string, VisualElement)

    Use this function to implement a handler for when the user clicks on the Settings in the Settings window. You can fetch a settings Asset or set up UIElements UI from this function.

    Declaration
    public override abstract void OnActivate(string searchContext, VisualElement rootElement)
    Parameters
    Type Name Description
    string searchContext

    Search context in the search box on the Settings window.

    VisualElement rootElement

    Root of the UIElements tree. If you add to this root, the SettingsProvider uses UIElements instead of calling SettingsProvider.OnGUI to build the UI. If you do not add to this VisualElement, then you must use the IMGUI to build the UI.

    Overrides
    SettingsProvider.OnActivate(string, VisualElement)

    OnGUI(string)

    Use this function to draw the UI based on IMGUI. This assumes you haven't added any children to the rootElement passed to the OnActivate function.

    Declaration
    public override abstract void OnGUI(string searchContext)
    Parameters
    Type Name Description
    string searchContext

    Search context for the Settings window. Used to show or hide relevant properties.

    Overrides
    SettingsProvider.OnGUI(string)
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)