Version: 2021.3
언어: 한국어
C# 스크립트에서 UXML 로드
UQuery

UXML 요소 레퍼런스

다음 표에는 UnityEngine.UIElementsUnityEditor.UIElements 네임스페이스에서 이용 가능한 UXML 요소가 간략히 설명되어 있습니다.

기본 요소

Element 기능 네임스페이스 허용되는 자식 요소 속성
VisualElement 모든 시각적 요소의 기본 클래스입니다. UnityEngine.UIElements 원하는 VisualElement 개수 class: 공백으로 구분된 이름 리스트입니다.
style: 요소에 스타일을 지정하는 USS 지시문입니다.
name: 이 요소에 대한 고유한 문자열 식별자입니다.
picking-mode: Position 또는 Ignore로 설정합니다. 기본값은 Position입니다.
tooltip: 마우스 커서를 요소 위에 올리면 문자열이 표시됩니다.
focusable: 요소에 포커스를 둘 수 있는지 여부를 표시하는 부울입니다. 기본값은 false(포커스를 둘 수 없음)입니다. 지원이 중단된 focus-index 요소를 대체합니다.
tabindex: 요소의 포지션과 트리 포지션의 태빙을 정의하는 정수입니다. 양수 값은 태빙 우선 순위를 높입니다. 기본값은 0입니다. 지원이 중단된 focus-index 요소를 대체합니다.
view-data-key: 요소 직렬화에 사용되는 키를 정의하는 문자열입니다.
또한 이 요소는 다른 모든 속성을 허용합니다.
BindableElement SerializedProperty에 바인딩될 수 있는 요소입니다. 프로퍼티 값과 표시되는 값이 동기화됩니다. UnityEngine.UIElements 원하는 VisualElement 개수 binding-path: 이 요소가 바인딩되는 프로퍼티의 경로입니다.

유틸리티

Element 기능 네임스페이스 허용되는 자식 요소 속성
Box VisualElement와 유사하지만 콘텐츠 주위에 상자를 그리는 요소입니다. UnityEngine.UIElements 원하는 VisualElement 개수 VisualElement의 모든 속성
TextElement 텍스트를 표시하는 요소입니다. UnityEngine.UIElements None VisualElement의 모든 속성
text: 요소가 표시해야 하는 텍스트입니다.
Label 텍스트 레이블입니다. UnityEngine.UIElements None TextElement의 모든 속성
Image 이미지를 표시합니다. UnityEngine.UIElements None VisualElement의 모든 속성
IMGUIContainer IMGUI 콘텐츠를 그립니다. UnityEngine.UIElements None VisualElement의 모든 속성
focus-index 기본 값은 0입니다.
focusable 기본값은 true입니다.
Foldout 콘텐츠 숨김/표시 토글 버튼이 있는 요소입니다. UnityEngine.UIElements 원하는 VisualElement 개수 BindableElement의 모든 속성

템플릿

Element 기능 네임스페이스 허용되는 자식 요소 속성
Template Instance 요소를 사용하여 인스턴스화할 수 있는 또 다른 UXML 템플릿에 대한 레퍼런스입니다. UnityEngine.UIElements None name: 이 요소에 대한 고유한 문자열 식별자
path: 로드할 UXML 파일의 경로
Instance Template의 인스턴스 UnityEngine.UIElements None template: 인스턴스화할 Templatename
TemplateContainer 템플릿 컨테이너입니다. UnityEngine.UIElements None BindableElement의 모든 속성
template: 이 템플릿에 대한 문자열 식별자

컨트롤

Element 기능 네임스페이스 허용되는 자식 요소 속성
BaseField<T> 모든 필드의 추상 기본 클래스입니다. UnityEngine.UIElements None BindableElement의 모든 속성
focus-index 기본값은 0입니다.
focusable 기본값은 true입니다.
label: 필드와 연결된 레이블의 텍스트
BaseFieldTraits<ValueType, UxmlType> UnityEngine.UIElements None BaseField<ValueType>의 모든 속성
value: ValueType 타입 필드의 기본 값
Button 표준 푸시 버튼입니다. UnityEngine.UIElements None TextElement의 모든 속성
RepeatButton 누르고 있는 동안 액션을 반복 실행하는 버튼입니다. UnityEngine.UIElements None TextElement의 모든 속성
delay: 요소가 실행된 액션을 실행하기 전의 초기 지연 시간(단위: 밀리초)입니다. 기본값은 0입니다.
interval: 각 동작 반복 사이의 간격(단위: 밀리 초)입니다. 기본값은 0입니다.
Toggle 체크박스로 표시되는 토글 버튼입니다. UnityEngine.UIElements None BaseFieldTraits<bool, UxmlBoolAttributeDescription>의 모든 속성
text: 토글의 오른쪽 레이블입니다.
Scroller 스크롤 바입니다. UnityEngine.UIElements None VisualElement의 모든 속성
low-value: 최소 스크롤러 값
high-value: 최대 스크롤러 값
direction: Horizontal 또는 Vertical로 설정합니다. 기본값은 Vertical입니다.
value: 스크롤러 커서의 포지션
Slider 슬라이더입니다. UnityEngine.UIElements None BaseFieldTraits<float, UxmlFloatAttributeDescription>의 모든 속성
low-value: 최소 슬라이더 값
high-value: 최대 슬라이더 값
direction: Horizontal 또는 Vertical로 설정합니다. 기본값은 Horizontal입니다.
page-size: 슬라이더의 페이지 크기
SliderInt 정수 값의 슬라이더입니다. UnityEngine.UIElements None BaseFieldTraits<int, UxmlIntAttributeDescription>의 모든 속성
low-value: 최소 슬라이더 값
high-value: 최대 슬라이더 값
direction: Horizontal 또는 Vertical로 설정합니다. 기본값은 Horizontal입니다.
page-size: 슬라이더의 페이지 크기
MinMaxSlider 사용자가 최소값과 최대값을 지정할 수 있도록 해주는 슬라이더입니다. UnityEngine.UIElements None BaseField<Vector2>의 모든 속성
low-limit: 최소 스크롤러 값
high-limit: 최대 스크롤러 값
min-value: 최소 슬라이더 커서 값
max-value: 최대 슬라이더 커서 값
EnumField 기본 Enum의 문자열 값을 취하는 필드입니다. UnityEditor.UIElements None BaseField<Enum>의 모든 속성
type: 기본 Enum의 C# 타입을 나타내는 문자열입니다. 타입이 사용자 어셈블리에 있는 경우 어셈블리 이름을 타입 이름에 추가해야 합니다. MyNamespace.MyEnum, MyAssembly. type 문자열은 항상 필수입니다.
value: 필드의 값을 나타내는 문자열
MaskField 사용자가 값 그룹을 선택할 수 있는 팝업 메뉴입니다. UnityEditor.UIElements None BaseField<int>의 모든 속성
choices: 팝업 메뉴에 표시하기 위한 최대 32개의 선택 옵션 리스트(쉼표로 구분됨)
value: 필드의 값을 32비트 마스크로 나타내는 정수입니다.
LayerField 사용자가 레이어를 선택할 수 있는 팝업 메뉴입니다. UnityEditor.UIElements None BaseField<int>의 모든 속성
value: 필드의 값을 나타내는 정수(선택된 레이어 번호)입니다.
LayerMaskField 사용자가 레이어 그룹을 선택할 수 있는 팝업 메뉴입니다. UnityEditor.UIElements None MaskField의 모든 속성
TagField 사용자가 태그를 선택할 수 있는 팝업 메뉴입니다. UnityEditor.UIElements None BaseField<string>의 모든 속성
value: 필드의 값을 나타내는 문자열(선택된 태그 이름)입니다.
ProgressBar 작업 진행도를 표시하는 진행 표시줄입니다. UnityEditor.UIElements None BindableElement의 모든 속성
low-value: 진행 표시줄의 최저값을 나타내는 플로트입니다. 기본값은 0입니다.
high-value: 진행 표시줄의 최고값을 나타내는 플로트입니다. 기본값은 100입니다.
title: 진행 표시줄의 제목을 나타내는 문자열입니다.

텍스트 입력

Element 기능 네임스페이스 허용되는 자식 요소 속성
TextInputBaseField<TValueType> 모든 텍스트 필드의 추상 기본 클래스입니다. UnityEngine.UIElements None BaseFieldTraits<string, UxmlStringAttributeDescription>의 모든 속성
text: 필드의 텍스트 값
max-length: 필드가 포함할 수 있는 최대 문자 수입니다. 기본값 -1은 텍스트 길이에 제한을 두지 않습니다.
password: 필드 콘텐츠를 maskCharacter 문자를 사용하여 표시할지 여부를 나타내는 부울입니다. 기본값은 false입니다.
mask-character: passwordtrue이면 필드 콘텐츠를 표시하는 문자입니다. 기본값은 * 문자입니다.
readonly: 읽기 전용 필드인지 표시하는 부울입니다. 기본값은 false입니다.
TextField 편집 가능한 텍스트 필드입니다. UnityEngine.UIElements None TextInputBaseField<string>의 모든 속성
multiline: 텍스트 필드가 텍스트를 여러 줄에 표시하는지 여부를 나타내는 부울입니다. true로 설정하면 여러 줄에 텍스트를 표시하고, false로 설정하면 텍스트 줄바꿈을 무시하고 한 줄에 텍스트를 표시합니다. 기본값은 false입니다.
IntegerField 정수(32비트) 값을 허용하는 텍스트 필드입니다. UnityEditor.UIElements None BaseFieldTraits<int, UxmlIntAttributeDescription>의 모든 속성
LongField 긴 정수(64비트) 값을 허용하는 텍스트 필드입니다. UnityEditor.UIElements None BaseFieldTraits<long, UxmlLongAttributeDescription>의 모든 속성
FloatField 단일 정밀도 부동 소수점 값을 허용하는 텍스트 필드입니다. UnityEditor.UIElements None BaseFieldTraits<float, UxmlFloatAttributeDescription>의 모든 속성
DoubleField 이중 정밀도 부동 소수점 값을 허용하는 텍스트 필드입니다. UnityEditor.UIElements None BaseFieldTraits<double, UxmlDoubleAttributeDescription>의 모든 속성
Vector2Field Vector2 값을 편집하기 위해 부동 소수점 값을 허용하는 두 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Vector2>의 모든 속성
x: X 좌표의 값
y: Y 좌표의 값
Vector2IntField Vector2Int 값을 편집하기 위해 정수 값을 허용하는 두 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Vector2Int>의 모든 속성
x: X 좌표의 값
y: Y 좌표의 값
Vector3Field Vector3 값을 편집하기 위해 부동 소수점 값을 허용하는 세 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Vector3>의 모든 속성
x: X 좌표의 값
y: Y 좌표의 값
z: Z 좌표의 값
Vector3IntField Vector3Int 값을 편집하기 위해 정수 값을 허용하는 세 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Vector3Int>의 모든 속성
x: X 좌표의 값
y: Y 좌표의 값
z: Z 좌표의 값
Vector4Field Vector4 값을 편집하기 위해 부동 소수점 값을 허용하는 네 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Vector4>의 모든 속성
x: X 좌표의 값
y: Y 좌표의 값
z: Z 좌표의 값
w: W 좌표의 값
RectField 직사각형 값을 편집하기 위해 부동 소수점 값을 허용하는 네 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Rect>의 모든 속성
x: 왼쪽 상단 모서리 X 좌표의 값
y: 왼쪽 상단 모서리 Y 좌표의 값
w: 직사각형의 너비
h: 직사각형의 높이
RectIntField 직사각형 값을 편집하기 위해 정수 값을 허용하는 네 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<RectInt>의 모든 속성
x: 왼쪽 상단 모서리 X 좌표의 값
y: 왼쪽 상단 모서리 Y 좌표의 값
w: 직사각형의 너비
h: 직사각형의 높이
BoundsField 바운딩 직사각형 값을 편집하기 위해 부동 소수점 값을 허용하는 여섯 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<Bounds>의 모든 속성
cx: 중앙 X 좌표의 값
cy: 중앙 Y 좌표의 값
cz: 중앙 Z 좌표의 값
ex: 범위 X 좌표의 값
ey: 범위 Y 좌표의 값
ez: 범위 Z 좌표의 값
BoundsIntField 바운딩 직사각형 값을 편집하기 위해 정수 값을 허용하는 여섯 개의 텍스트 필드 집합입니다. UnityEditor.UIElements None BaseField<BoundsInt>의 모든 속성
px: 포지션 X 좌표의 값
py: 포지션 Y 좌표의 값
pz: 포지션 Z 좌표의 값
sx: 크기 X 좌표의 값
sy: 크기 Y 좌표의 값
sz: 크기 Z 좌표의 값

복합 위젯

Element 기능 네임스페이스 허용되는 자식 요소 속성
PropertyField 값을 편집하기 위한 레이블과 필드입니다. UnityEditor.UIElements None VisualElement의 모든 속성
binding-path: 이 요소가 바인딩되는 프로퍼티의 경로
label: 필드의 레이블
ColorField 컬러 피커 필드입니다. UnityEditor.UIElements None BaseFieldTraits<Color, UxmlColorAttributeDescription>의 모든 속성
show-eye-dropper: 아이드로퍼를 표시할지 여부를 나타내는 부울입니다. true로 설정하면 아이드로퍼를 표시하고 false로 설정하면 숨깁니다. 기본값은 true입니다.
show-alpha: 알파 컨트롤을 표시할지 여부를 나타내는 부울입니다. true로 설정하면 알파 컨트롤을 표시하고 false로 설정하면 숨깁니다. 기본값은 true입니다.
hdr: HDR 컬러 피커를 사용할지 여부를 나타내는 부울입니다. true로 설정하면 컬러 피커를 사용합니다. 기본값은 false입니다.
CurveField 커브 에디터 필드입니다. UnityEditor.UIElements None BaseField<AnimationCurve>의 모든 속성
GradientField 그레디언트 에디터 필드입니다. UnityEditor.UIElements None BaseField<Gradient>의 모든 속성
ObjectField 오브젝트 선택기 필드입니다. UnityEditor.UIElements None BaseField<Object>의 모든 속성
allow-scene-objects: 씬에서 오브젝트를 선택할 수 있는지 여부를 표시하는 부울입니다. true로 설정하면 오브젝트 선택을 활성화하고 false로 설정하면 비활성화합니다. 기본값은 true입니다.
InspectorElement 인스펙터 창에서 프로퍼티를 표시하는 요소입니다. UnityEditor.UIElements 원하는 VisualElement 개수 BindableElement의 모든 속성

툴바

Element 기능 네임스페이스 허용되는 자식 요소 속성
Toolbar 툴바 항목을 보관하는 컨테이너입니다. UnityEditor.UIElements 모든 VisualElement VisualElement의 모든 속성
ToolbarButton 툴바를 위한 버튼입니다. UnityEditor.UIElements None Button의 모든 속성
ToolbarToggle 툴바를 위한 토글입니다. UnityEditor.UIElements None Toggle의 모든 속성
ToolbarMenu 툴바를 위한 드롭다운 메뉴입니다. 메뉴에는 아래쪽 화살표가 하나 있습니다. UnityEditor.UIElements None TextElement의 모든 속성
ToolbarSearchField 툴바를 위한 검색 필드입니다. UnityEditor.UIElements None VisualElement의 모든 속성
ToolbarPopupSearchField 검색 옵션의 팝업 메뉴가 포함된 검색 필드입니다. UnityEditor.UIElements None VisualElement의 모든 속성
ToolbarSpacer 툴바 버튼 사이에 고정된 양의 공백을 삽입하는 요소입니다. UnityEditor.UIElements None VisualElement의 모든 속성

뷰와 창

Element 기능 네임스페이스 허용되는 자식 요소 속성
ListView 요소 리스트를 표시합니다. UnityEngine.UIElements None VisualElement의 모든 속성<br/>item-height: 리스트 내 각 항목의 높이(단위: 픽셀)| |ScrollView| 수평 및 수직 스크롤러가 있는 스크롤 가능 뷰입니다.|UnityEngine.UIElements| 원하는VisualElement개수 |VisualElement의 모든 속성<br/>mode: 스크롤 뷰의 모드입니다. 기본값은ScrollViewMode.Vertical입니다.<br/>show-horizontal-scroller: 수평 스크롤러를 표시할지 여부를 나타내는 부울입니다. 기본값은false입니다.<br/>show-vertical-scroller: 수직 스크롤러를 표시할지 여부를 나타내는 부울입니다. 기본값은false입니다.<br/>horizontal-page-size: 수평 스크롤러의 페이지 크기 값<br/>vertical-page-size: 수직 스크롤러의 페이지 크기| |TreeView| 트리 계층 구조의 요소를 표시하는 뷰입니다.|UnityEngine.UIElements| 원하는VisualElement개수 |VisualElement의 모든 속성
item-height: 표시된 기본 리스트의 항목 높이
PopupWindow 다른 콘텐츠 위에 표시되는 UIElements 창 UnityEditor.UIElements None TextElement의 모든 속성

  • 2019–05–20 페이지 수정됨
C# 스크립트에서 UXML 로드
UQuery
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961