Unity 사용자 매뉴얼: RectIntField
Unity는 다양한 UI 요소를 제공하여 게임과 애플리케이션의 사용자 인터페이스(UI)를 효율적으로 구성할 수 있도록 돕습니다. 이 문서는 RectIntField라는 UI 요소에 대한 개요 및 활용 방법을 설명합니다.
1. RectIntField란 무엇인가?
RectIntField는 Unity UI Toolkit에서 제공하는 UI 요소로, 정수형 사각형(rectangle)의 크기를 입력받는 필드입니다. 사용자가 값을 수치적으로 입력할 수 있도록 하여 UI를 더 직관적으로 만들 수 있습니다.
2. UXML 요소 및 C# 클래스 정보
기본 클래스 및 네임스페이스
- 기본 클래스: BaseCompositeField_3
- 네임스페이스: UnityEngine.UIElements
주요 속성
| 속성명 | 타입 | 설명 |
|---|---|---|
| binding-path | string | 바인드될 타겟 프로퍼티의 경로입니다. |
| focusable | boolean | 요소에 포커스를 맞출 수 있을 경우 true입니다. |
| label | string | 필드 옆에 표시될 레이블을 나타내는 문자열입니다. |
| tabindex | int | 포커스 링에서 포커스를 맞출 수 있는 항목을 정렬하는 데 사용되는 정수입니다. |
| content-container | string | 자식 요소가 추가되는 공간입니다. |
| name | string | VisualElement의 이름입니다. |
| styles | string | 요소의 스타일 오브젝트에 대한 레퍼런스입니다. |
| tooltip | string | 사용자가 마우스를 요소 위에 놓았을 때 정보 박스에 표시할 텍스트입니다. |
| usage-hints | UIElements.UsageHints | VisualElement의 고수준 의도된 사용 패턴을 지정하는 힌트 값입니다. |
| view-data-key | string | 보기 데이터 지속성에 사용되는 키입니다. |
3. C# 프로퍼티와 USS 선택자
RectIntField UI 요소와 관련된 C# 프로퍼티와 USS 선택자는 다음과 같습니다:
| C# 프로퍼티 | USS 선택자 | 설명 |
|---|---|---|
| ussClassName | .unity-rect-int-field | 이 타입 요소의 USS 클래스명입니다. |
| label | .unity-rect-int-field__label | 레이블의 USS 클래스명입니다. |
| input | .unity-rect-int-field__input | 입력 요소의 USS 클래스명입니다. |
| ... | ... | ... (추가적인 USS 선택자와 설명) |
4. 사용 예제
RectIntField를 Unity 프로젝트에서 사용하는 방법은 다음과 같습니다:
예제 1: 기본 RectIntField 생성
using UnityEngine;
using UnityEngine.UIElements;
public class RectIntFieldExample : MonoBehaviour
{
void Start()
{
var rectIntField = new RectIntField("Enter Value:");
rectIntField.value = new RectInt(10, 20, 100, 200);
// UI에 추가하는 코드
}
}
예제 2: RectIntField에 이벤트 추가
using UnityEngine;
using UnityEngine.UIElements;
public class RectIntFieldEvent : MonoBehaviour
{
void Start()
{
var rectIntField = new RectIntField("Coordinates:");
rectIntField.RegisterValueChangedCallback(evt =>
{
Debug.Log($"New Rect: {evt.newValue}");
});
// UI에 추가하는 코드
}
}
5. 요약
RectIntField는 사용자가 정수형 데이터를 입력할 수 있는 간단하면서도 강력한 방법입니다. UI 요소의 여러 속성과 이벤트를 활용하여, 사용자 경험을 개선하는 데 유용합니다. Unity UI Toolkit에서 다양한 UI 요소를 활용하는 방법을 더 알아보며 프로젝트를 더욱 풍부하게 만들어보세요.