ObjectField

ObjectField는 사용자가 사용 가능한 오브젝트 목록에서 Unity 오브젝트를 선택할 수 있도록 하는 에디터 전용 요소입니다. 이를 사용하여 머티리얼이나 텍스처, 스크립트, 게임 오브젝트와 같이 레퍼런스로 사용할 Unity 오브젝트를 선택할 수 있습니다.

참고: 요소를 인스펙터 창의 다른 필드와 정렬하려면 .unity-base-field__aligned USS 클래스를 적용하기만 하면 됩니다. 자세한 내용은 BaseField를 참조하십시오.

ObjectField 생성

UI 빌더나 UXML, C#을 사용하여 ObjectField를 생성할 수 있습니다.

선택할 수 있는 오브젝트의 유형을 제한하려면 type 프로퍼티를 사용합니다. UXML에서 type 프로퍼티의 포맷은 Type Name, Type assembly name입니다.

팁: 어느 유형의 어셈블리 이름을 찾으려면 Debug.Log(theType.AssemblyQualifiedName);를 사용하거나 해당 유형의 스크립트 API 페이지에서 찾으십시오.

다음 예시에서는 2D 텍스처를 선택하기 위한 ObjectField를 생성합니다.

UXML:

<ObjectField type="UnityEngine.Texture2D, UnityEngine.CoreModule" label="Select an object:" />

C#:

using UnityEditor.UIElements;
...
var objectField = new ObjectField();
objectField.objectType = typeof(Texture2D);
objectField.label = "Select an object:";

예제

다음 UXML 예시에서는 ObjectField를 생성합니다.

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <uie:ObjectField label="UXML Field" name="the-uxml-field" />
</UXML>

다음 C# 예시는 MinMaxSlider의 커스터마이즈 가능한 기능 중 일부를 나타냅니다.

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<ObjectField>("the-uxml-field");
uxmlField.value = new Texture2D(10, 10) { name = "new_texture" };

// Create a new field, disable it, and give it a style class.
var csharpField = new ObjectField("C# Field");
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<Object>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

Unity에서 이 예시를 실시간으로 실행하려면 Window > UI Toolkit > Samples로 이동하십시오.

C# 기본 클래스 및 네임스페이스

C# 클래스: ObjectField
네임스페이스: UnityEditor.UIElements
기본 클래스: BaseField_1

구성원 UXML 속성

이 요소에는 다음 구성원 속성이 있습니다.

상속 UXML 속성

이 요소는 다음 속성을 해당 기본 클래스에서 상속합니다.

이 요소는 또한 다음 속성을 VisualElement에서 상속합니다.

USS 클래스

다음 표는 모든 C# 공용 프로퍼티 이름과 관련 USS 선택자의 리스트입니다.

또한 인스펙터 또는 UI 툴킷 디버거의 매칭 선택자 섹션을 사용하여 해당 계층 구조의 모든 레벨에서 VisualElement 컴포넌트에 영향을 주는 USS 선택자를 확인할 수도 있습니다.

추가 리소스

• VisualElement
• 어셈블리 정의