두 가지 속성을 사용하여 커스텀 컨트롤 만들기

버전: 2023.2+

이 예제에서는 두 가지 속성을 가진 간단한 커스텀 컨트롤을 만드는 방법을 보여줍니다.

개요 예시

이 예제에서는 두 개의 속성을 포함한 MyElement라는 커스텀 컨트롤을 생성하여 UXML 및 UI 빌더에 노출합니다. 이 예제에서는 UI 빌더에서 UI에 커스텀 컨트롤을 추가하는 방법도 보여 줍니다.

이 예제에서 완성한 파일은 이 GitHub 저장소에서 확인할 수 있습니다.

선행 조건

이 가이드는 Unity, UI 툴킷, C# 스크립팅에 익숙한 개발자용입니다.시작하기 전에 먼저 다음을 숙지하십시오.

• UXML
• UI 빌더

예시 생성

C#에서 새 커스텀 컨트롤 클래스를 만들려면 VisualElement 클래스에서 상속합니다. 이렇게 하면 C#에서 이 요소를 생성하고 사용할 수 있지만, 요소가 UXML 및 UI 빌더에 자동으로 노출되지는 않습니다. 이 요소를 노출하려면 UxmlElement 속성을 추가합니다. 속성을 노출하려면 UXML 및 UI 빌더에서 표시하려는 각 프로퍼티에 UxmlAttribute 속성을 추가합니다.

1. 임의의 템플릿을 사용하여 Unity 프로젝트를 생성합니다.
2. Assets 폴더에 다음 콘텐츠로 MyElement.cs라는 이름의 C# 스크립트를 생성합니다.

[!code-cs]

UXML을 생성하여 속성 확인

1. 원하는 이름으로 UXML 파일을 만듭니다.
2. UXML 파일을 더블 클릭하여 UI 빌더에서 엽니다.
3. UI 빌더의 Library 섹션에서 Project > Custom Controls (C#) > MyElement를 선택합니다.
4. MyElement를 계층 창으로 드래그합니다.
5. MyElement에 대한 커스텀 속성을 보려면 MyElement의 Inspector 탭으로 이동합니다.

추가 리소스

• 커스텀 컨트롤 만들기