Unity 매뉴얼: UI 요소와 사용법
이 문서는 Unity의 UI 요소인 RepeatButton에 대한 설명을 제공합니다. RepeatButton은 사용자의 클릭 및 유지 입력을 처리하는 버튼의 일종으로, UI 툴킷을 통해 쉽게 구현할 수 있습니다.
UXML 요소: RepeatButton
네임스페이스 및 부모 클래스
- C# 클래스:
RepeatButton - 네임스페이스:
UnityEngine.UIElements - 기본 클래스:
TextElement
주요 속성
다음은 RepeatButton이 제공하는 주요 속성입니다.
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| binding-path | string | 바인드될 타겟 프로퍼티의 경로입니다. |
| display-tooltip-when-elided | boolean | true인 경우 툴팁에 생략된 텍스트의 전체 버전이 표시됩니다. |
| enable-rich-text | boolean | false인 경우 리치 텍스트 태그가 파싱되지 않습니다. |
| focusable | boolean | 요소에 포커스를 맞출 수 있는지를 결정합니다. true일 경우 포커스를 받을 수 있습니다. |
| tabindex | int | 포커스 링에서 포커스를 맞출 수 있는 항목을 정렬하는 데 사용되는 정수입니다. 0보다 크거나 같아야 합니다. |
| text | string | 표시되는 텍스트입니다. 이 값을 변경하면 관련 이벤트가 발생합니다. |
VisualElement 속성 상속
RepeatButton은 VisualElement에서 일부 속성을 상속받습니다.
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| content-container | string | 자식 요소가 추가되며, 일반적으로 요소와 동일합니다. |
| name | string | VisualElement의 이름입니다. 특정 요소를 타게팅하는 USS 선택자를 작성하는 데 사용됩니다. |
| picking-mode | UIElements.PickingMode | 요소를 선택할 수 있는지를 결정하는 방식입니다. |
| style | string | 요소의 스타일 오브젝트에 대한 레퍼런스입니다. USS 파일에서 계산된 데이터 또는 C#에서 인라인 스타일로 작성된 내용 포함. |
| tooltip | string | 사용자가 마우스를 요소 위에 두었을 때 표시할 텍스트입니다. |
| usage-hints | UIElements.UsageHints | VisualElement에 대한 고수준의 사용 패턴을 지정하는 힌트 값입니다. |
| view-data-key | string | 보기 데이터 지속성에 사용됩니다. 이 키를 설정하지 않으면 VisualElement에 대한 지속성이 비활성화됩니다. |
코드 예제
Unity의 RepeatButton을 사용하는 간단한 코드 예제입니다.
using UnityEngine;
using UnityEngine.UIElements;
public class RepeatButtonExample : MonoBehaviour
{
private void OnEnable()
{
var uiDocument = GetComponent<UIDocument>();
var root = uiDocument.rootVisualElement;
// RepeatButton 생성
var repeatButton = new RepeatButton();
repeatButton.text = "Hold Me!";
repeatButton.RegisterCallback<ClickEvent>(ev => Debug.Log("Button Clicked"));
root.Add(repeatButton);
}
}
활용 및 응용 예제
- 게임 내 쇼핑 카트:
RepeatButton을 사용하여 사용자가 아이템을 빠르게 추가하거나 삭제할 수 있는 버튼을 만듭니다. - 설정 조정: 버튼을 길게 눌러 게임의 설정을 조정할 수 있는 컨트롤러로 활용합니다.
- 진행 바: 사용자가 버튼을 길게 눌러 특정 작업(예: 로딩, 저장)을 진행할 수 있는 UI 요소로 사용할 수 있습니다.
이 문서에서는 RepeatButton의 기본 개념과 사용법을 설명했습니다. 더 복잡한 예제와 실제 어플리케이션에서의 사용 방법에 대해서는 Unity 공식 문서를 참고하세요.