Version: 2020.3
Loading UXML from C#
UQuery

UXML 요소 레퍼런스

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

기본 요소

Element 기능 Namespace Permitted child elements Attributes
VisualElement The base class for all visual elements. UnityEngine.UIElements Any number of VisualElement class: A list of space separated names.
style: USS directives to style the element.
name: A unique string identifier for this element.
picking-mode: Set to Position or Ignore. The default value is Position.
tooltip: When the mouse hovers the element a string displays.
focusable: A Boolean that indicates whether the element is focusable. The default is set to false (not focusable). This replaces the obsolete focus-index element.
tabindex: An integer that defines the tabbing position of the element and the position in the tree. A positive value increases tabbing priority. The default is 0. This replaces the obsolete focus-index element.
view-data-key : A string that defines the key used for serialization of the element.
This element also accepts any other attribute.
BindableElement SerializedProperty에 바인딩될 수 있는 요소입니다. 프로퍼티 값과 표시되는 값이 동기화됩니다. UnityEngine.UIElements Any number of VisualElement binding-path: The path of the property that this element is bound to.

유틸리티

Element 기능 Namespace Permitted child elements Attributes
Box This element is similar to VisualElement but draws a box around its content. UnityEngine.UIElements Any number of VisualElement All attributes of VisualElement
TextElement 텍스트를 표시하는 요소입니다. UnityEngine.UIElements None All attributes of VisualElement
text: The text the element should display.
Label 텍스트 레이블입니다. UnityEngine.UIElements None All attributes of TextElement
Image 이미지를 표시합니다. UnityEngine.UIElements None All attributes of VisualElement
IMGUIContainer Draws IMGUI content UnityEngine.UIElements None All attributes of VisualElement
focus-index default value is 0
focusable default value is true
Foldout An element that has a toggle button to show or hide its content. UnityEngine.UIElements Any number of VisualElement All attributes of BindableElement

템플릿

Element 기능 Namespace Permitted child elements Attributes
Template Instance 요소를 사용하여 인스턴스화할 수 있는 또 다른 UXML 템플릿에 대한 레퍼런스입니다. UnityEngine.UIElements None name: A unique string identifier for this element
path: The path of the UXML file to load
Instance Instance of a Template UnityEngine.UIElements None template: The name of the Template to instantiate
TemplateContainer A template container. UnityEngine.UIElements None All attributes of BindableElement
template: A string identifier for this template

컨트롤

Element 기능 Namespace Permitted child elements Attributes
BaseField<T> 모든 필드의 추상 기본 클래스입니다. UnityEngine.UIElements None All attributes of BindableElement
focus-index default value is 0
focusable default value is true
label: The text of the label that is associated with the field
BaseFieldTraits<ValueType, UxmlType> UnityEngine.UIElements None All attributes of BaseField<ValueType>
value: The base value of the field, of type ValueType
Button 표준 푸시 버튼입니다. UnityEngine.UIElements None All attributes of TextElement
RepeatButton 누르고 있는 동안 액션을 반복 실행하는 버튼입니다. UnityEngine.UIElements None All attributes of TextElement
delay: The initial delay in milliseconds before the element executes the action is executed. The default value is 0
interval: The interval in milliseconds between repeating each action. The default value is 0
Toggle A toggle button, displayed as a checkbox. UnityEngine.UIElements None All attributes of BaseFieldTraits<bool, UxmlBoolAttributeDescription>
text : Right side label of the toggle.
Scroller 스크롤 바입니다. UnityEngine.UIElements None All attributes of VisualElement
low-value: The minimum value of the scroller
high-value: The maximum value of the scroller
direction: Set to Horizontal or Vertical. The default is Vertical.
value: The position of the scroller cursor
Slider 슬라이더입니다. UnityEngine.UIElements None All attributes of BaseFieldTraits<float, UxmlFloatAttributeDescription>
low-value: The minimum value of the slider
high-value: The maximum value of the slider
direction: Set to Horizontal or Vertical. The default is Horizontal.
page-size: The page size of the slider
SliderInt 정수 값의 슬라이더입니다. UnityEngine.UIElements None All attributes of BaseFieldTraits<int, UxmlIntAttributeDescription>
low-value: The minimum value of the slider
high-value: The maximum value of the slider
direction: Set to Horizontal or Vertical. The default is Horizontal.
page-size: The page size of the slider
MinMaxSlider A slider that lets the user specify a minimum and a maximum value. UnityEngine.UIElements None All attributes of BaseField<Vector2>
low-limit: The minimum value of the scroller
high-limit: The maximum value of the scroller
min-value: The minimum value of the slider cursor
max-value: The maximum value of the slider cursor
EnumField A field that takes the string values of an underlying Enum. UnityEditor.UIElements None All attributes of BaseField<Enum>
type: A string representing the C# type of the underlying Enum. If the type is in a user assembly, the assembly name must be added to the type name: MyNamespace.MyEnum, MyAssembly. The type string is always required.
value: A string that represents the value of the field
MaskField A popup menu that the user can select a group of values from. UnityEditor.UIElements None All attributes of BaseField<int>
choices: A comma separated list of up to 32 choices to display in the popup menu
value: An integer that represents the value of the field as a 32-bit mask.
LayerField A popup menu that the user can select a layer from. UnityEditor.UIElements None All attributes of BaseField<int>
value: An integer that represents the value of the field (the selected layer number).
LayerMaskField A popup menu that the user can select a group of layers from. UnityEditor.UIElements None All attributes of MaskField
TagField A popup menu that the user can select a tag from. UnityEditor.UIElements None All attributes of BaseField<string>
value: A string that represents the value of the field (the selected tag name).
ProgressBar A progress bar that shows the progression of an operation. UnityEditor.UIElements None All attributes of BindableElement
low-value: A float that represents the lowest value of the progress bar. The default is 0.
high-value: A float that represents the highest value of the progress bar. The default is 100.
title: A string that represents the title of the progress bar.

텍스트 입력

Element 기능 Namespace Permitted child elements Attributes
TextInputBaseField<TValueType> 모든 텍스트 필드의 추상 기본 클래스입니다. UnityEngine.UIElements None All attributes of BaseFieldTraits<string, UxmlStringAttributeDescription>
text: The text value of the field
max-length: The maximum number of characters that the field can contain. Default value of -1 sets no limits on the text length.
password: A boolean that indicates whether the field content should be shown or displayed using the maskCharacter character. false is the default setting.
mask-character: A character that displays the field content when password is true. Default is the character *.
readonly: A boolean that indicates that the field is read-only. The default value is false
TextField 편집 가능한 텍스트 필드입니다. UnityEngine.UIElements None All attributes of TextInputBaseField<string>
multiline: A boolean that indicates whether the text field displays its text on multiple lines. Set to true to display on multiple lines, or set to false to display or on a single line, ignoring any line break in the text. false is the default.
IntegerField A text field that accepts an integer (32-bit) value. UnityEditor.UIElements None All attributes of BaseFieldTraits<int, UxmlIntAttributeDescription>
LongField A text field that accepts a long integer (64 bits) value. UnityEditor.UIElements None All attributes of BaseFieldTraits<long, UxmlLongAttributeDescription>
FloatField A text field that accepts a single precision floating point value. UnityEditor.UIElements None All attributes of BaseFieldTraits<float, UxmlFloatAttributeDescription>
DoubleField A text field that accepts a double precision floating point value. UnityEditor.UIElements None All attributes of BaseFieldTraits<double, UxmlDoubleAttributeDescription>
Vector2Field A set of two text fields that accept floating point values to edit the value of a Vector2. UnityEditor.UIElements None All attributes of BaseField<Vector2>
x: The value of the X coordinate
y: The value of the Y coordinate
Vector2IntField A set of two text fields that accept integer values to edit the value of a Vector2Int. UnityEditor.UIElements None All attributes of BaseField<Vector2Int>
x: The value of the X coordinate
y: The value of the Y coordinate
Vector3Field A set of three text fields that accept floating point values to edit the value of a Vector3. UnityEditor.UIElements None All attributes of BaseField<Vector3>
x: The value of the X coordinate
y: The value of the Y coordinate
z: The value of the Z coordinate
Vector3IntField A set of three text fields that accept integer values to edit the value of a Vector3Int. UnityEditor.UIElements None All attributes of BaseField<Vector3Int>
x: The value of the X coordinate
y: The value of the Y coordinate
z: The value of the Z coordinate
Vector4Field A set of four text fields that accept floating point values to edit the value of a Vector4. UnityEditor.UIElements None All attributes of BaseField<Vector4>
x: The value of the X coordinate
y: The value of the Y coordinate
z: The value of the Z coordinate
w: The value of the W coordinate
RectField A set of four text fields that accept floating point values to edit the value of a rectangle. UnityEditor.UIElements None All attributes of BaseField<Rect>
x: The value of the top left corner X coordinate
y: The value of the top left corner Y coordinate
w: The width of the rectangle
h: the height of the rectangle
RectIntField A set of four text fields that accept integer values to edit the value of a rectangle. UnityEditor.UIElements None All attributes of BaseField<RectInt>
x: The value of the top left corner X coordinate
y: The value of the top left corner Y coordinate
w: The width of the rectangle
h: the height of the rectangle
BoundsField A set of six text fields that accept floating point values to edit the value of a bounding rectangle. UnityEditor.UIElements None All attributes of BaseField<Bounds>
cx: The value of the center X coordinate
cy: The value of the center Y coordinate
cz: The value of the center Z coordinate
ex: The value of the extent X coordinate
ey: The value of the extent Y coordinate
ez: The value of the extent Z coordinate
BoundsIntField A set of six text fields that accept integer values to edit the value of a bounding rectangle. UnityEditor.UIElements None All attributes of BaseField<BoundsInt>
px: The value of the position X coordinate
py: The value of the postion Y coordinate
pz: The value of the position Z coordinate
sx: The value of the size X coordinate
sy: The value of the size Y coordinate
sz: The value of the size Z coordinate

복합 위젯

Element 기능 Namespace Permitted child elements Attributes
PropertyField 값을 편집하기 위한 레이블과 필드입니다. UnityEditor.UIElements None All attributes of VisualElement
binding-path: The path of the property this element is bound to
label: The label for the field
PropertyControl<int> A label and a field to edit a value of type int. UnityEditor.UIElements None All attributes of BaseField<int>
value-type: A string that represents the type of value
value: The value for the field
PropertyControl<long> A label and a field to edit a value of type long. UnityEditor.UIElements None All attributes of BaseField<long>
value-type: A string that represents the type of value
value: The value for the field
PropertyControl<float> A label and a field to edit a value of type float. UnityEditor.UIElements None All attributes of BaseField<float>
value-type: A string that represents the type of value
value: The value for the field
PropertyControl<double> A label and a field to edit a value of type double. UnityEditor.UIElements None All attributes of BaseField<double>
value-type: A string that represents the type of value
value: The value for the field
PropertyControl<string> A label and a field to edit a value of type string. UnityEditor.UIElements None All attributes of BaseField<string>
value-type: A string that represents the type of value
value: The value for the field
ColorField 컬러 피커 필드입니다. UnityEditor.UIElements None All attributes of BaseFieldTraits<Color, UxmlColorAttributeDescription>
show-eye-dropper: A boolean that indicates whether to show the eye dropper or not. Set to true to display the eye dropper, and false to hide it. By default this is set to true.
show-alpha: A boolean that indicates whether to show the alpha control. Set to true to show the control or false to hide it. By default this is set to true.
hdr: A boolean that indicates whether to use the high dynamic range color picker. Set to true to use the picker. By default this is set to false.
CurveField 커브 에디터 필드입니다. UnityEditor.UIElements None All attributes of BaseField<AnimationCurve>
GradientField 그레디언트 에디터 필드입니다. UnityEditor.UIElements None All attributes of BaseField<Gradient>
ObjectField 오브젝트 선택기 필드입니다. UnityEditor.UIElements None All attributes of BaseField<Object>
allow-scene-objects: A boolean that indicates whether objects from the scene can be selected. Set to true to enable object selection or false disable it. By default this is set to true.
InspectorElement 인스펙터 창에서 프로퍼티를 표시하는 요소입니다. UnityEditor.UIElements Any number of VisualElement All attributes of BindableElement

툴바

Element 기능 Namespace Permitted child elements Attributes
Toolbar 툴바 항목을 보관하는 컨테이너입니다. UnityEditor.UIElements Any VisualElement All attributes of VisualElement
ToolbarButton 툴바를 위한 버튼입니다. UnityEditor.UIElements None All attributes of Button
ToolbarToggle 툴바를 위한 토글입니다. UnityEditor.UIElements None All attributes of Toggle
ToolbarMenu 툴바를 위한 드롭다운 메뉴입니다. 메뉴에는 아래쪽 화살표가 하나 있습니다. UnityEditor.UIElements None All attributes of TextElement
ToolbarSearchField 툴바를 위한 검색 필드입니다. UnityEditor.UIElements None All attributes of VisualElement
ToolbarPopupSearchField 검색 옵션의 팝업 메뉴가 포함된 검색 필드입니다. UnityEditor.UIElements None All attributes of VisualElement
ToolbarSpacer An element that inserts a fixed amount of whitespace between toolbar buttons. UnityEditor.UIElements None All attributes of VisualElement

뷰와 창

Element 기능 Namespace Permitted child elements Attributes
ListView 요소 리스트를 표시합니다. UnityEngine.UIElements None All attributes of VisualElement
item-height: The height in pixels of each item in the list
ScrollView 수평 및 수직 스크롤러가 있는 스크롤 가능 뷰입니다. UnityEngine.UIElements Any number of VisualElement All attributes of VisualElement
mode: the mode of the scroll view. By default this is set to ScrollViewMode.Vertical
show-horizontal-scroller: A boolean that indicates whether to show the horizontal scroller. By default this is set to false
show-vertical-scroller: A boolean that indicates whether to show the vertical scroller. By default this is set to false
horizontal-page-size: The page size value of the horizontal scroller
vertical-page-size: The page size of the vertical scroller
TreeView A view for displaying elements in a tree hierarchy. UnityEngine.UIElements Any number of VisualElement All attributes of VisualElement
item-height: The height of an item in the underlying list shown
PopupWindow 다른 콘텐츠 위에 표시되는 UIElements 창 UnityEditor.UIElements None All attributes of TextElement

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