UXML 元素 FloatField

FloatField 允许用户将数值浮点型值输入到应用程序中。它接受并显示文本输入。您可以设置占位符文本以向用户提供有关输入内容的提示或说明。您还可以添加验证函数以确保输入的数据满足特定要求。

注意：要使 FloatField 与 检视器一个 Unity 窗口，用于显示有关当前选定游戏对象、资源或项目设置的信息，允许您检查和编辑值。 更多信息
参见 术语表 窗口中的其他字段对齐，只需将 .unity-base-field__aligned USS 类应用于它即可。有关更多信息，请参阅 BaseField。

创建 FloatField

您可以使用 UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。 更多信息
参见 术语表 构建器、UXML 和 C# 创建 FloatField。以下 C# 示例创建具有值更改回调的 FloatField

FloatField myElement = new FloatField("Label text");

// Align the float field with the other fields.
myElement.AddToClassList("unity-base-field__aligned");
myElement.value = 0.5f;

// To delay the value change callback until the user has finished editing the value, set the isDelayed property to true.
myElement.isDelayed = true;
myElement.RegisterValueChangedCallback(evt => Debug.Log("New value: " + evt.newValue));

设置占位符文本

您可以为元素设置占位符文本。您还可以隐藏聚焦时的占位符文本。

注意：如果您为元素设置了值，占位符文本将不会显示。要取消设置 UI 构建器中的值，请右键单击元素的检视器选项卡中的值字段，然后选择取消设置。

在 C# 中，使用 placeholder 和 hidePlaceholderOnFocus 属性，通过 textEdition

myElement.textEdition.placeholder = "Enter your value here";
myElement.textEdition.hidePlaceholderOnFocus = true;

要设置占位符文本的样式，请使用 .unity-base-text-field__input--placeholder USS 选择器。

自定义输入文本选择

输入文本默认情况下是可选择的。您可以自定义选择行为，例如 selectAllOnMouseUP 和 selectAllOnFocus。

在 C# 中，通过 textSelection 设置它们

myElement.textSelection.selectAllOnMouseUp = false;
myElement.textSelection.selectAllOnFocus = false;

示例

以下 UXML 示例创建带有占位符的 FloatField

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <FloatField label="UXML Field" name="the-uxml-field" />
</UXML>

以下 C# 示例说明了 FloatField 的一些可自定义功能

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<FloatField>("the-uxml-field");
uxmlField.value = 42.4f;

// Create a new field, disable it, and give it a style class.
var csharpField = new FloatField("C# Field");
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<float>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

要尝试在 Unity 中实时使用此示例，请转到窗口 > UI 工具包 > 示例。

C# 基类和命名空间

C# 类：FloatField
命名空间：UnityEngine.UIElements
基类：TextValueField_1

继承的 UXML 属性

此元素从其基类继承以下属性

此元素还从 VisualElement 继承以下属性

USS 类

下表列出了所有 C# 公共属性名称及其相关的 USS 选择器。

您还可以使用 检视器或 UI 工具包调试器中的匹配选择器部分 来查看哪些 USS 选择器影响 VisualElement 层次结构中每一级的组件。

其他资源

• UXML 元素 Label
• UXML 元素 TextField
• UXML 元素 IntegerField
• UXML 元素 DoubleField
• UXML 元素 LongField
• UXML 元素 PropertyField