SliderInt

SliderInt를 사용하면 사용자가 다양한 값 중에서 정수 값을 선택할 수 있습니다. SliderInt를 사용하여 게임 내 목숨 수와 같은 값을 조정할 수 있습니다. 값을 설정하려면 트랙을 따라 썸(thumb)을 드래그하거나 트랙 자체를 클릭합니다. 슬라이더에는 값을 직접 수정할 수 있는 텍스트 입력 필드도 포함될 수 있습니다.

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

SliderInt 생성

UI 빌더, UXML, C#을 사용하여 SliderInt를 생성할 수 있습니다. 다음 C# 예시에서는 기본값, 낮은 값, 높은 값으로 SliderInt를 생성하고 슬라이더의 방향을 설정합니다.

var sliderInt = new SliderInt();
sliderInt.value = 42;
sliderInt.lowValue = 0;
sliderInt.highValue = 100;
sliderInt.direction = SliderDirection.Horizontal;

페이지 크기 설정

SliderInt 컨트롤에는 썸의 양쪽으로 트랙을 클릭할 때 썸이 얼마나 움직이고 값이 얼마나 변하는지 제어하는 page-size 프로퍼티가 있습니다.

페이지 크기 값이 0이면 트랙을 클릭할 경우 썸이 커서 또는 포인터 위치로 이동하고 그에 따라 값이 업데이트됩니다.

페이지 크기 값이 0보다 큰 경우 트랙을 클릭하면 썸이 커서 또는 포인터 위치를 향해 특정 거리만큼 이동합니다. SliderInt 컨트롤은 page-size를 절대값으로 취급합니다.

예를 들어 전체 범위가 200이고 페이지 크기가 20이면 페이지 크기 양은 절대값인 20입니다. 트랙을 클릭할 때마다 썸이 움직이고 값이 20만큼 증가하거나 감소합니다.

예제

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

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <SliderInt
        label="UXML Slider"
        name="the-uxml-slider"
        low-value="0"
        high-value="100"
        page-size="1"
        value="42" />
</UXML>

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

/// <sample>
// Get a reference to the slider from UXML and assign it its value.
var uxmlSlider = container.Q<SliderInt>("the-uxml-slider");
uxmlSlider.value = 42;

// Create a new slider, disable it, and give it a style class.
var csharpSlider = new SliderInt("C# Slider", 0, 100);
csharpSlider.SetEnabled(false);
csharpSlider.AddToClassList("some-styled-slider");
csharpSlider.value = uxmlSlider.value;
container.Add(csharpSlider);

// Mirror value of uxml slider into the C# field.
uxmlSlider.RegisterCallback<ChangeEvent<int>>((evt) =>
{
    csharpSlider.value = evt.newValue;
});
/// </sample>

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

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

C# 클래스: SliderInt
네임스페이스: UnityEngine.UIElements
기본 클래스: BaseSlider_1

구성원 UXML 속성

이 요소에는 다음 구성원 속성이 있습니다.

상속 UXML 속성

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

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

USS 클래스

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

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

추가 리소스

• Slider
• MinMaxSlider