Version: 2018.4
언어: 한국어
C#에서 UXML 로드
UQuery

UXML 요소 레퍼런스

여기에서는 UnityEngine.Experimental.UIElementsUnityEditor.Experimental.UIElements 네임스페이스에서 이용 가능한 UXML 요소를 상세하게 설명합니다.

기본 요소

VisualElement

모든 시각적 요소의 기본 클래스입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • class: 공백으로 구분된 이름 목록
    • style: 요소의 스타일 지정을 위한 USS 지시문
    • name: 이 요소에 대한 고유한 문자열 식별자
    • focus-index: 태빙 시 포커스 순서를 결정하는 데 사용하는 정수. 기본값은 -1이며 요소에 포커스를 둘 수 없음
    • picking-mode: Position 또는 Ignore. 기본값은 Position
    • tooltip: 마우스 커서가 요소 위에 있을 때 표시되는 문자열
    • slot-name: 이 요소를 슬롯으로 정의
    • slot: 요소가 <Instance> 안에 있으면 요소를 이 속성이 참조하는 슬롯 안으로 옮김
    • 또한 다른 모든 속성을 허용

BindableElement

SerializedProperty에 바인딩될 수 있는 요소입니다. 프로퍼티 값과 표시되는 값이 동기화됩니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • VisualElement의 모든 속성
    • binding-path: 이 요소가 바인딩되는 프로퍼티의 경로

유틸리티

Box

VisualElement와 유사하지만 콘텐츠 주위에 상자를 그립니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • VisualElement의 모든 속성

TextElement

텍스트를 표시하는 요소입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
    • text: 요소에 의해 표시되는 텍스트

Label

텍스트 레이블입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • TextElement의 모든 속성

Image

이미지를 표시합니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성

IMGUIContainer

IMGUI 콘텐츠를 그리는 요소입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
      • focus-index 기본 값은 0입니다.

Foldout

콘텐츠 숨김/표시 토글 버튼이 있는 요소입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • BindableElement의 모든 속성

템플릿

Template

Instance 요소를 사용하여 인스턴스화할 수 있는 또 다른 UXML 템플릿에 대한 레퍼런스입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • name: 이 요소에 대한 고유한 문자열 식별자
    • path: 로드할 UXML 파일의 경로입니다.

Instance

Template의 인스턴스입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • template: 인스턴스화할 Templatename

컨트롤

Button

표준 푸시 버튼입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • TextElement의 모든 속성

RepeatButton

누르고 있는 동안 액션을 반복 실행하는 버튼입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • TextElement의 모든 속성
    • delay: 액션이 실행되기 전 초기 지연 시간(단위: 밀리초). 기본값은 0
    • interval: 각 액션 반복 사이의 간격(단위: 밀리초). 기본값은 0

Toggle

토글 버튼(체크박스)입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • label: 토글의 텍스트 레이블
    • value: 토글 켜기/끄기를 표시하는 부울

Scroller

스크롤 바입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
    • low-value: 스크롤러의 최소값
    • high-value: 스크롤러의 최대값
    • direction: Horizontal 또는 Vertical. 기본값은 Vertical
    • value: 스크롤러 커서의 포지션

ScrollerButton

스크롤 바의 끝에 있는 버튼입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
    • delay: 액션이 실행되기 전 초기 지연 시간(단위: 밀리초). 기본값은 0
    • interval: 각 액션 반복 사이의 간격(단위: 밀리초). 기본값은 0

Slider

슬라이더입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
    • low-value: 슬라이더의 최소값
    • high-value: 슬라이더의 최대값
    • direction: Horizontal 또는 Vertical. 기본값은 Vertical
    • page-size: 슬라이더의 페이지 크기
    • value: 슬라이더 커서의 포지션

SliderInt

정수 값의 슬라이더입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
    • low-value: 슬라이더의 최소값
    • high-value: 슬라이더의 최대값
    • direction: Horizontal 또는 Vertical. 기본값은 Vertical
    • page-size: 슬라이더의 페이지 크기
    • value: 슬라이더 커서의 포지션

MinMaxSlider

사용자가 최소값과 최대값을 지정할 수 있도록 해주는 슬라이더입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
    • low-limit: 스크롤러의 최소값
    • high-limit: 스크롤러의 최대값
    • min-value: 슬라이더 커서의 최소값
    • max-value: 슬라이더 커서의 최대값

EnumField

기본 Enum의 문자열 값만 취할 수 있는 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • type: 필수. 기본 Enum의 C# 타입을 나타내는 문자열
    • value: 필드의 값을 나타내는 문자열

MaskField

사용자가 값 그룹을 선택할 수 있도록 해주는 팝업 메뉴입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • choices: 팝업 메뉴에 표시하기 위한 최대 32개의 선택 옵션 리스트. 쉼표로 구분됨.
    • value: 필드의 값을 32비트 마스크로 나타내는 정수

LayerField

사용자가 레이어를 선택할 수 있도록 해주는 팝업 메뉴입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값을 나타내는 정수(선택된 레이어 번호)

LayerMaskField

사용자가 레이어 그룹을 선택할 수 있도록 해주는 팝업 메뉴입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • MaskField의 모든 속성

TagField

사용자가 태그를 선택할 수 있도록 해주는 팝업 메뉴입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값을 나타내는 문자열(선택된 태그 이름)

텍스트 입력

TextField

편집 가능한 텍스트 필드입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • text: 필드의 텍스트 값
    • max-length: 필드가 포함할 수 있는 최대 문자 수. 기본값 -1은 텍스트 길이에 아무 제한도 설정하지 않습니다.
    • password: 필드 콘텐츠를 표시(false, 기본값) 또는 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다.
    • mask-character: passwordtrue일 때 필드 콘텐츠를 표시하기 위해 사용하는 문자입니다. 기본값은 문자 *입니다.
    • multiline: 텍스트 필드가 여러 줄에 텍스트를 표시할지(true), 아니면 하나의 줄에 표시하고 텍스트 내 줄바꿈을 무시할지(false, 기본값) 여부를 나타내는 부울입니다.

IntegerField

정수(32비트) 값을 허용하는 텍스트 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값
    • text: 필드의 텍스트 값
    • max-length: 필드가 포함할 수 있는 최대 문자 수. 기본값 -1은 텍스트 길이에 아무 제한도 설정하지 않습니다.
    • password: 필드 콘텐츠를 표시(false, 기본값) 또는 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다.
    • mask-character: passwordtrue일 때 필드 콘텐츠를 표시하기 위해 사용하는 문자입니다. 기본값은 문자 *입니다.

LongField

긴 정수(64비트) 값을 허용하는 텍스트 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값
    • text: 필드의 텍스트 값
    • max-length: 필드가 포함할 수 있는 최대 문자 수. 기본값 -1은 텍스트 길이에 아무 제한도 설정하지 않습니다.
    • password: 필드 콘텐츠를 표시(false, 기본값) 또는 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다.
    • mask-character: passwordtrue일 때 필드 콘텐츠를 표시하기 위해 사용하는 문자입니다. 기본값은 문자 *입니다.

FloatField

단일 정밀도 부동 소수점 값을 허용하는 텍스트 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값
    • text: 필드의 텍스트 값
    • max-length: 필드가 포함할 수 있는 최대 문자 수. 기본값 -1은 텍스트 길이에 아무 제한도 설정하지 않습니다.
    • password: 필드 콘텐츠를 표시(false, 기본값) 또는 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다.
    • mask-character: passwordtrue일 때 필드 콘텐츠를 표시하기 위해 사용하는 문자입니다. 기본값은 문자 *입니다.

DoubleField

이중 정밀도 부동 소수점 값을 허용하는 텍스트 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 필드의 값
    • text: 필드의 텍스트 값
    • max-length: 필드가 포함할 수 있는 최대 문자 수. 기본값 -1은 텍스트 길이에 아무 제한도 설정하지 않습니다.
    • password: 필드 콘텐츠를 표시(false, 기본값) 또는 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다.
    • mask-character: passwordtrue일 때 필드 콘텐츠를 표시하기 위해 사용하는 문자입니다. 기본값은 문자 *입니다.

Vector2Field

Vector2 값을 편집하기 위해 부동 소수점 값을 허용하는 두 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: X 좌표의 값
    • y: Y 좌표의 값

Vector2IntField

Vector2Int 값을 편집하기 위해 정수 값을 허용하는 두 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: X 좌표의 값
    • y: Y 좌표의 값

Vector3Field

Vector3 값을 편집하기 위해 부동 소수점 값을 허용하는 세 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: X 좌표의 값
    • y: Y 좌표의 값
    • z: Z 좌표의 값

Vector3IntField

Vector3Int 값을 편집하기 위해 정수 값을 허용하는 세 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: X 좌표의 값
    • y: Y 좌표의 값
    • z: Z 좌표의 값

Vector4Field

Vector4 값을 편집하기 위해 부동 소수점 값을 허용하는 네 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: X 좌표의 값
    • y: Y 좌표의 값
    • z: Z 좌표의 값
    • w: W 좌표의 값

RectField

직사각형 값을 편집하기 위해 부동 소수점 값을 허용하는 네 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: 왼쪽 상단 모서리 X 좌표의 값
    • y: 왼쪽 상단 모서리 Y 좌표의 값
    • w: 직사각형의 너비
    • h: 직사각형의 높이

RectIntField

직사각형 값을 편집하기 위해 정수 값을 허용하는 네 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • x: 왼쪽 상단 모서리 X 좌표의 값
    • y: 왼쪽 상단 모서리 Y 좌표의 값
    • w: 직사각형의 너비
    • h: 직사각형의 높이

BoundsField

바운딩 직사각형 값을 편집하기 위해 부동 소수점 값을 허용하는 여섯 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • cx: 중앙 X 좌표의 값
    • cy: 중앙 Y 좌표의 값
    • cz:중앙 Z 좌표의 값
    • ex: 범위 X 좌표의 값
    • ey: 범위 Y 좌표의 값
    • ez: 범위 Z 좌표의 값

BoundsIntField

바운딩 직사각형 값을 편집하기 위해 정수 값을 허용하는 여섯 개의 텍스트 필드 집합입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • px: 중앙 X 좌표의 값
    • py: 중앙 Y 좌표의 값
    • pz:중앙 Z 좌표의 값
    • sx: 범위 X 좌표의 값
    • sy: 범위 Y 좌표의 값
    • sz: 범위 Z 좌표의 값

복합 위젯

PropertyField

값을 편집하기 위한 레이블과 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • binding-path: 이 요소가 바인딩되는 프로퍼티의 경로
    • label: 필드의 레이블

ColorField

컬러 피커 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • value: 컬러 값(Color)
    • show-eye-dropper: 아이드로퍼를 표시할지(true, 기본값), 숨길지(false) 여부를 나타내는 부울
    • show-alpha:알파 컨트롤을 표시할지(true, 기본값), 숨길지(false) 여부를 나타내는 부울
    • hdr: 컬러 피커의 HDR을 사용할지(true, 기본값), 일반 HDR을 사용할지(false) 여부를 나타내는 부울

CurveField

커브 에디터 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.

GradientField

그레디언트 에디터 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.

ObjectField

오브젝트 선택기 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • BindableElement의 모든 속성
      • focus-index 기본 값은 0입니다.
    • allow-scene-objects: 씬의 오브젝트를 선택할지(true, 기본값), 선택하지 않을지(false) 여부를 나타내는 부울

InspectorElement

인스펙터 창에서 프로퍼티를 표시하는 요소입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • BindableElement의 모든 속성

툴바

Toolbar

툴바 항목을 보관하는 컨테이너입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 모든 VisualElement
  • 속성:
    • VisualElement의 모든 속성

ToolbarButton

툴바를 위한 버튼입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • Button/의 모든 속성

ToolbarToggle

툴바를 위한 토글입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • Toggle의 모든 속성

ToolbarMenu

툴바를 위한 드롭다운 메뉴입니다. 메뉴에는 아래쪽 화살표가 하나 있습니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • TextElement의 모든 속성

ToolbarPopup

툴바를 위한 팝업 메뉴입니다. 메뉴에는 위쪽/아래쪽 화살표가 두 개 있습니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • TextElement의 모든 속성

ToolbarSearchField

툴바를 위한 검색 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성

ToolbarPopupSearchField

검색 옵션의 팝업 메뉴가 포함된 검색 필드입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • ToolbarSearchField의 모든 속성

ToolbarSpacer

툴바 버튼 사이에 고정된 양의 공백을 삽입하는 요소입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성

ToolbarFlexSpacer

툴바 버튼 사이에 유연한 공백을 삽입하는 요소입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성

뷰와 창

ListView

요소 리스트를 표시합니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 없음
  • 속성:
    • VisualElement의 모든 속성
    • item-height: 리스트 내 각 항목의 높이(단위: 픽셀)

ScrollView

수평 및 수직 스크롤러가 있는 스크롤 가능 뷰입니다.

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • VisualElement의 모든 속성
    • show-horizontal-scroller: 수평 스크롤러를 표시할지 여부를 나타내는 부울(기본값은 false)
    • show-vertical-scroller: 수직 스크롤러를 표시할지 여부를 나타내는 부울(기본값은 false)
    • horizontal-page-size: 수평 스크롤러의 페이지 크기 값
    • vertical-page-size: 수직 스크롤러의 페이지 크기
    • stretch-content-width: 콘텐츠가 뷰의 너비에 맞게 늘어나도록 만들지 여부를 나타내는 부울

PopupWindow

다른 콘텐츠 위에 표시되는 UIElements 창

  • UnityEngine.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • TextElement의 모든 속성

VisualSplitter

사용자가 분할된 바를 드래그하여 자식의 크기를 조절하도록 해주는 컨테이너입니다.

  • UnityEditor.Experimental.UIElements에서
  • 허용되는 자식 요소: 원하는 수만큼의 VisualElement
  • 속성:
    • VisualElement의 모든 속성

  • 2018–11–02 일부 편집 리뷰를 거쳐 페이지 수정됨
C&#35;에서 UXML 로드
UQuery