This section describes the data type conversions and fields supported by

PropertyField

.

Most built-in controls in UI Toolkit implement the

INotifyValueChanged

interface for a specific data type. For example, implements , which means you can bind the control to a property of type . You can bind more data types with the binding system. For example, you can bind a property of type to a .

The following table lists the source and target data types that you can bind:

long

int

double

float

char

PropertyField

When the Inspector window is populated, if a custom Editor doesn't exist for a type, the binding system calls

InspectorElement.FillDefaultInspector()

. This creates a

PropertyField

for each

SerializedProperty

on the .

Each

PropertyField

has a matching control under it, such as an to represent an , or a to represent a . If the property has sub-properties, the

PropertyField

has a control. That has the appropriate default controls under each sub-property. If you created a custom for a Property, the visual tree returned from the 's method is used instead.

When you create a custom UI, don't use a

PropertyField

unless you can't find a specific control for it. For example, to create a control in your visual tree and bind it to a , use a

ColorField

rather than a

PropertyField

. This makes visual trees more lightweight and operations faster.

The use of incurs additional overhead because it resolves the concrete field to use after binding. This extra step can affect performance. However, is beneficial for some uses. For example, it supports custom drawers, which you can use to handle specific properties in a personalized way. This eliminates the need to guess the field type for drawing, which can reduce errors.

The following table lists fields supported by

PropertyField

and their data type:

BoundsField

BoundsIntField

ColorField

CurveField

FloatField

GradientField

Hash128Field

IntegerField

IntegerField

LayerMaskField

LongField

ObjectField

PopupField

RectField

RectIntField

TextField

TextField

Toggle

Vector2Field

Vector2IntField

Vector3Field

Vector3IntField

Vector4Field