Unity UI Toolkit의 UXML 요소: Vector4Field 및 Vector3IntField
이 문서는 Unity에서 UI 요소를 설정하고 사용하는 방법에 대해 설명합니다. 특히 Vector4Field와 Vector3IntField UXML 요소를 중심으로 한 내용입니다. 이 문서는 Unity의 다양한 버전에서 사용 가능한 스크립팅 API에 대한 정보를 제공합니다.
UXML 요소: Vector4Field
네임스페이스
UnityEngine.UIElements
기본 클래스
BaseCompositeField_3
속성
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| binding-path | string | 바인딩할 타겟 프로퍼티의 경로 |
| focusable | boolean | 요소에 포커스를 맞출 수 있는지 여부 |
| label | string | 필드 옆에 표시될 레이블 텍스트 |
| tabindex | int | 포커스 링 정렬을 위한 정수 (0 이상) |
VisualElement 속성 상속
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| content-container | string | 자식 요소가 추가되는 컨테이너의 이름 |
| name | string | VisualElement의 고유 이름 |
| picking-mode | UIElements.PickingMode | 선택할 수 있는지를 결정하는 모드 |
| style | string | 요소의 스타일 객체에 대한 참조 |
| tooltip | string | 마우스를 요소 위에 놓았을 때 표시될 텍스트 |
사용 예시
Vector4Field를 사용하여 UI에서 4D 벡터 값을 입력받고 표시할 수 있습니다. 이는 게임 오브젝트의 위치, 회전 또는 스케일과 같은 다양한 속성에 유용하게 사용할 수 있습니다.
Vector4Field vector4Field = new Vector4Field("Position");
vector4Field.bindingPath = "transform.position";
this.Add(vector4Field);
UXML 요소: Vector3IntField
네임스페이스
UnityEngine.UIElements
기본 클래스
BaseCompositeField_3
속성
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| binding-path | string | 바인딩할 타겟 프로퍼티의 경로 |
| focusable | boolean | 요소에 포커스를 맞출 수 있는지 여부 |
| label | string | 필드 옆에 표시될 레이블 텍스트 |
| tabindex | int | 포커스 링 정렬을 위한 정수 (0 이상) |
VisualElement 속성 상속
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| content-container | string | 자식 요소가 추가되는 컨테이너의 이름 |
| name | string | VisualElement의 고유 이름 |
| picking-mode | UIElements.PickingMode | 선택할 수 있는지를 결정하는 모드 |
| style | string | 요소의 스타일 객체에 대한 참조 |
| tooltip | string | 마우스를 요소 위에 놓았을 때 표시될 텍스트 |
사용 예시
Vector3IntField는 3D 좌표 값을 정수로 입력받을 수 있게 하는 UI 요소입니다. 이를 통해 게임 상의 특정 위치를 제어할 수 있습니다.
Vector3IntField vector3IntField = new Vector3IntField("Grid Position");
vector3IntField.bindingPath = "gridPosition";
this.Add(vector3IntField);
결론
이 문서에서 설명한 Vector4Field 및 Vector3IntField는 Unity의 UI Toolkit을 사용하여 복잡한 데이터 구조를 간단하고 직관적으로 입력받고 표시할 수 있는 방법을 제공합니다. 이를 통해 게임 개발자는 보다 사용자 친화적인 인터페이스를 쉽게 구축할 수 있습니다. 다양한 설정과 속성을 활용해 보세요!