Unity 매뉴얼: UI 요소 - MaskField

Unity의 UI Toolkit에서 MaskField는 UI 요소 중 하나로, 사용자 입력을 관리하는 데 사용되는 구성 요소입니다. 이 문서에서는 MaskField의 속성과 사용법을 한국어로 설명하고 몇 가지 예제를 추가하겠습니다.

MaskField 개요

MaskField는 비밀번호와 같이 사용자에게 입력되는 값을 숨길 수 있는 입력 필드입니다. 주로 비밀번호 입력 시 사용됩니다.

주요 속성

C# 클래스 및 USS 클래스

MaskField의 관련 C# 상속 및 USS 선택자 표는 아래와 같습니다.

활용 예제

1. 기본 MaskField 생성

아래 코드는 MaskField를 생성하고 UI에 추가하는 간단한 예제입니다.

using UnityEngine;
using UnityEngine.UIElements;

public class MaskFieldExample : MonoBehaviour
{
    void Start()
    {
        var root = GetComponent<UIDocument>().rootVisualElement;

        // MaskField 생성
        var maskField = new MaskField("Password")
        {
            label = "Enter Password"
        };

        root.Add(maskField);
    }
}

2. MaskField의 값 가져오기

사용자가 입력한 값을 가져오는 방법은 아래와 같습니다.

using UnityEngine;
using UnityEngine.UIElements;

public class MaskFieldValueExample : MonoBehaviour
{
    void Start()
    {
        var root = GetComponent<UIDocument>().rootVisualElement;

        // MaskField 생성
        var maskField = new MaskField("Password")
        {
            label = "Enter Password"
        };

        root.Add(maskField);

        // 이벤트 등록 - 값 변화 감지
        maskField.RegisterValueChangedCallback(evt =>
        {
            Debug.Log("Input Value: " + evt.newValue);
        });
    }
}

결론

MaskField는 Unity의 UI 시스템에서 비밀번호와 같은 민감한 정보를 처리할 때 유용한 도구입니다. 위에서 설명한 속성과 예제를 바탕으로 다양한 UI 요소와 함께 활용하여 사용자 경험을 향상시킬 수 있습니다.