EditorGUILayout

Автоматическая расположенная версия EditorGUI.

Этот класс во многом повторяет функциональность EditorGUIЭто полезно для размещения кнопок и других GUI элементов, когда вы не беспокоитесь о точном расположении пикселей каждого элемента, а интересуетесь только относительным расположением ваших элементов.

EditorGUILayout имеет два основных вида методов: Методы для определения области и методы для создания GUI элементов. Если элемент определен вне области, по умолчанию он будет вертикально выравниваться.

Методы определения областей часто разделяются на пару методов: один начинается со слова «Begin», а другой — со слова «End». Например: EditorGUILayout.BeginHorizontal и EditorGUILayout.EndHorizontal. Любой EditorGUI или EditorGUILayout код, находящийся между методом "Begin" и методом "End", будет размещён в GUI рядом с другими элементами в соответствии с использованным методом области. Например, все элементы, размещённые после EditorGUILayout.BeginHorizontal Элементы GUI после этого вызова будут расположены горизонтально рядом друг с другом. Область можно вложить в другую область, но учтите: каждому вызову Begin должен соответствовать вызов End, иначе возникнут ошибки.

Одно из отличий EditorGUILayout от GUILayout является пока GUILayout.BeginHorizontal и другие аналогичные методы не имеют типа возврата, EditorGUILayout возвращает Rect Этот Rect затем может быть передан методам, не являющимся EditorGUILayout, чтобы включить их в область, ограниченную методами EditorGUILayout.

В зависимости от того, какой из методов "Begin" вы используете, тип возврата и точный метод его использования будут несколько отличаться. По возможности, проверяйте документацию для каждого используемого метода, чтобы убедиться, что вы используете его правильно.

После того, как вы определили область в коде, вы можете заполнить GUI полями, которые будут содержать элементы, которые могут быть видны или взаимодействовать с вашими пользователями. Некоторые примеры методов, используемых для создания полей: EditorGUILayout.LabelField, EditorGUILayout.PasswordField, и EditorGUILayout.Toggle.

Методы EditorGUILayout используются вместе с GUILayout и EditorGUI методов создания полностью функционирующей системы GUI. Некоторые методы имеются только в одном из этих APIs, так что хорошо проверить все из них, если вы не можете найти конкретный элемент, который вы хотели бы использовать. Например, для создания кнопки, вы хотите использовать GUILayout.Button.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEditor;

public class EditorGUILayoutExample : EditorWindow
{
    Vector2 scrollPos;
    string t = "This is a label inside a Scroll view!";

    [MenuItem("Examples/EditorGUILayout Example")]
    static void Init()
    {
        EditorGUILayoutExample window = (EditorGUILayoutExample)EditorWindow.GetWindow(typeof(EditorGUILayoutExample), true, "My Empty Window");
        window.Show();
    }

    void OnGUI()
    {
        // Creates a horizontally laid out group
        EditorGUILayout.BeginHorizontal();

        // Creates a ScrollView within that group
        scrollPos =
            EditorGUILayout.BeginScrollView(scrollPos, GUILayout.Width(100), GUILayout.Height(100));

        // Creates a label element within the ScrollView
        GUILayout.Label(t);

        // Ends the ScrollView
        EditorGUILayout.EndScrollView();

        // Places a button within the Horizontal area, but outside the ScrollView
        if (GUILayout.Button("Add More Text", GUILayout.Width(100), GUILayout.Height(100)))
            t += " \nAnd this is more text!";

        // Ends the Horizontal area
        EditorGUILayout.EndHorizontal();

        // Places a button outside the Horizontal area
        if (GUILayout.Button("Clear"))
            t = "";
    }
}