Unity 매뉴얼: UXML 요소 및 C# 클래스 개요

이 문서는 Unity에서 사용자 인터페이스(UI)를 만들 때 사용하는 UXML 요소와 C# 클래스를 다룹니다. 주로 InspectorElement 클래스를 중심으로 설명하며, 기본 속성과 활용에 대해서도 알아보겠습니다.

UXML 요소란?

UXML은 Unity에서 XML 형식으로 UI를 정의하는 방법입니다. 요소들은 UI 구성 요소를 나타내며, 각 요소는 특정 속성을 가집니다. 아래는 InspectorElement 클래스의 주요 속성입니다.

InspectorElement 속성

C# 클래스 및 USS 선택자

UXML의 각 클래스는 특정 USS 스타일을 가집니다. 아래는 InspectorElement 클래스와 관련된 USS 선택자 표입니다.

활용 및 응용 예제

Unity에서 UXML과 InspectorElement를 활용하는 방법은 다양합니다.

예제 1: 사용자 정의 인스펙터 생성하기

기본적인 인스펙터 UI를 커스텀할 때, UXML을 이용해 UI 요소를 구성할 수 있습니다.

using UnityEngine;
using UnityEditor;
using UnityEngine.UIElements;

public class CustomInspectorExample : Editor
{
    public override VisualElement CreateInspectorGUI()
    {
        // UXML 파일 로드
        var visualTree = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Assets/Editor/MyCustomInspector.uxml");
        VisualElement root = visualTree.CloneTree();

        // 속성 바인딩
        var targetProperty = serializedObject.FindProperty("targetProperty");
        var myField = root.Q<IntegerField>("myField");
        myField.BindProperty(targetProperty);

        return root;
    }
}

위 예제는 Custom Inspector를 만들어 특정 속성을 바인딩하는 방법을 보여줍니다.

예제 2: UI 스타일 적용하기

USS 파일을 사용하여 UI 요소의 스타일을 어떻게 지정할 수 있는지 다음과 같이 예를 들 수 있습니다.

using UnityEngine;
using UnityEngine.UIElements;

public class StyleExample : MonoBehaviour
{
    void Start()
    {
        var visualElement = new VisualElement();
        visualElement.AddToClassList("custom-element"); // CSS 클래스 추가
        visualElement.style.width = 100; // 스타일 속성 지정
        visualElement.style.height = 50;
    }
}

위 코드 조각은 custom-element라는 CSS 클래스를 추가하여 UI 요소의 스타일을 적용하는 방법을 보여줍니다.

결론

UXML과 C# 클래스를 활용하여 Unity에서 다양한 UI 요소를 구성하고, 사용자 정의 인스펙터를 만드는 등 여러 방법으로 활용할 수 있습니다. 이 문서에서 소개한 내용은 간단한 예제일 뿐이며, 여러분의 프로젝트에 맞게 확장하여 적용할 수 있습니다.