DropdownField

DropdownField를 사용하면 사용자가 목록에서 값을 선택할 수 있습니다. 컨트롤을 클릭하면 여러 옵션을 제공하는 드로어가 열리고 사용자가 하나를 선택할 수 있습니다. 항상 모든 옵션을 표시하려면 RadioButtonGroup을 사용하십시오.

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

DropdownField 생성

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

UI 빌더

UI 빌더에서 DropdownField의 옵션을 추가하려면 DropdownField의 인스펙터 패널에서 Choices에 옵션을 쉼표로 구분하여 입력합니다.

기본값을 설정하려면 DropdownField의 인스펙터에서 Index에 옵션의 번호 지정 순서를 0부터 입력합니다.

C#

다음 C# 예시에서는 세 가지 옵션이 있는 DropdownField를 생성합니다. DropdownField는 기본적으로 첫 번째 옵션을 선택합니다.

var dropdown = new DropdownField("Options", new List<string> { "Option 1", "Option 2", "Option 3" }, 0);

//Add another option
dropdown.choices.Add("Option 4");

// To return int value instead of string
dropdown.index = 1; // Option 2
dropdown.value = "Option3";
Assert.IsTrue(myDropdown.index == 2);

// Register to the value changed callback
dropdown.RegisterValueChangedCallback(evt => Debug.Log(evt.newValue));

DropdownField의 스타일 변경

USS 파일의 기본 Panel Settings 필드를 오버라이드하여 DropdownField의 스타일을 변경할 수 있습니다.

1. Hierarchy 창에서__ UI__(사용자 인터페이스) 사용자가 애플리케이션과 상호 작용하도록 해 줍니다. Unity는 현재 3개의 UI 시스템을 지원합니다. 자세한 정보
   See in Glossary 문서(.uxml)를 선택합니다.
2. Panel Settings를 패널 설정 에셋으로 설정합니다. 기존 Panel Settings 에셋이 없는 경우 다이얼로그의 지침에 따라 생성합니다.
3. Panel Settings 에셋에서 테마 스타일시트를 할당합니다.
4. Project 창에서 TSS 파일을 선택합니다.
5. Style Sheets로 이동하여 Add(+) 버튼을 선택합니다.
6. Style Sheet를 USS 파일로 설정합니다.

예제

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

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

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

/// <sample>
// You can provide the list of choices by code, or by comma separated values in UXML
// <DropdownField .... choices="Option 1,Option 2,Option 3" .... />
var choices = new List<string> { "Option 1", "Option 2", "Option 3" };

// Get a reference to the dropdown field from UXML and assign a value to it.
var uxmlField = container.Q<DropdownField>("the-uxml-field");
uxmlField.choices = choices;
uxmlField.value = choices[0];

// Create a new dropdown with the same choices, disable it, and give it a style class.
var csharpField = new DropdownField("C# Field", choices, 0);
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
container.Add(csharpField);

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

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

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

C# 클래스: DropdownField
네임스페이스: UnityEngine.UIElements
기본 클래스: PopupField_1

상속 UXML 속성

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

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

USS 클래스

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

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

추가 리소스

• RadioButtonGroup