IntegerField

IntegerField 允许用户输入数值整数值。它接受并显示文本输入。您可以设置占位文本来为用户提供有关输入内容的提示或说明。还可以添加验证函数来确保输入的数据满足特定要求。

注意：要将 IntegerField 与 Inspector 窗口中的其他字段对齐，只需将 .unity-base-field__aligned USS 类加以应用即可。有关更多信息，请参阅 BaseField。

创建 IntegerField

您可以使用__ UI__（即用户界面，User Interface）让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary Builder、UXML 和 C# 创建 IntegerField。以下 C# 代码将创建一个 IntegerField：

var integerField = new IntegerField("Label text");

设置占位文本

可为元素设置占位文本。还可以在焦点上隐藏占位文本。

注意：如果为元素设置了值，则不会显示占位文本。要在 UI Builder 中取消设置值，请右键单击元素的检视面板 (Inspector) 选项卡中的值 (Value) 字段，然后选择取消设置 (Unset)。

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

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 示例将创建一个 IntegerField：

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

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

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

// Create a new field, disable it, and give it a style class.
var csharpField = new IntegerField("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<int>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

要在 Unity 中实时试用此示例，请转到窗口 (Window) > UI 工具包 (UI Toolkit) > 示例 (Samples)。

C# 基类和命名空间

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

继承 UXML 属性

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

名称	类型	描述
`auto-correction`	`boolean`	确定触控屏键盘自动校正是打开还是关闭。
`binding-path`	`string`	要绑定的目标属性的路径。
`emoji-fallback-support`	`boolean`	指定系统在渲染文本时查找表情字符的顺序。如果启用此设置，将首先在全局表情回退列表中搜索被 Unicode 14.0 标准定义为表情的字符。
`focusable`	`boolean`	如果元素可以获得焦点，则为 true。
`hide-mobile-input`	`boolean`	隐藏或显示移动输入字段。
`is-delayed`	`boolean`	如果设置为 true，则在用户按下 Enter 或文本字段失去焦点之前不会更新值属性。
`keyboard-type`	`TouchScreenKeyboardType`	将使用的移动键盘类型。
`label`	`string`	表示字段旁边将显示的标签的字符串。
`max-length`	`int`	字段的最大字符数。
`select-all-on-focus`	`boolean`	控制在接收焦点时是否选择元素的内容。
`select-all-on-mouse-up`	`boolean`	控制在首次光标悬停时是否选择元素的内容。
`tabindex`	`int`	用于对焦点环中可获得焦点的元素排序的整数。必须大于或等于零。
`value`	`int`	与字段关联的值。
`vertical-scroller-visibility`	`UIElements.ScrollerVisibility`	用于控制 `TextInputBaseField_1` 中垂直滚动条可见性的选项。

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

名称	类型	描述
`content-container`	`string`	向其添加子元素，通常与元素本身相同。
`data-source`	`Object`	为此 VisualElement 分配一个数据源，此数据源将覆盖任何已继承的数据源。此数据源由所有子项继承。
`data-source-path`	`string`	从数据源到值的路径。
`data-source-type`	`System.Type`	可分配给此 VisualElement 的可能数据源的类型。仅当在设计时无法指定有效数据源时，UI Builder 才使用此信息作为补全数据源路径字段的提示。
`language-direction`	`UIElements.LanguageDirection`	指示元素文本的方向性。该值将传播到元素的子项。将 languageDirection 设置为 RTL，即可通过反转文本、处理换行和单词自动换行的方式，提供对从右到左 (RTL) 语言的基本支持。但是，它不提供全面的 RTL 支持，因为这需要文本整形（包括字符重新排序）和 OpenType 字体功能支持。未来更新计划提供全面的 RTL 支持，这将涉及额外的 API 来处理语言、脚本和字体功能规范。要增强此属性的 RTL 功能，用户可以在 Unity 资源商店中探索可用的第三方插件，并使用 `ITextElementExperimentalFeatures.renderedText`	`name`	`string`	此 VisualElement 的名称。使用此属性可编写针对特定元素的 USS 选择器。标准做法是为元素指定唯一名称。
`picking-mode`	`UIElements.PickingMode`	确定是否可以在 mouseEvents 或 `IPanel.Pick` 查询期间选择此元素。
`style`	`string`	设置 `VisualElement` 样式值。
`tooltip`	`string`	用户将光标悬停在元素上一小段时间后信息框内显示的文本。仅在编辑器 UI 中受支持。
`usage-hints`	`UIElements.UsageHints`	用于指定 `VisualElement` 高级预期使用模式的提示值组合。仅当 `VisualElement` 还不属于 `Panel` 的一部分时，才能设置此属性。一旦成为 `Panel` 的一部分，此属性实际上就变为只读，尝试更改此属性将显示异常。适当的 `UsageHints` 规范会促使系统根据预期的使用模式，做出更好的决策，以处理或加速某些操作。请注意，这些提示不会影响行为或视觉效果，只会影响面板及其元素的整体性能。建议始终考虑指定适当的 `UsageHints`，但请记住，在某些情况下（例如，由于目标平台上的硬件限制），某些 `UsageHints` 可能会在内部被忽略。
`view-data-key`	`string`	用于 View Data 持久性，例如树展开状态、滚动位置或缩放级别。此键用于保存和加载 View Data 存储中的视图数据。如果未设置此键，则会对关联的 `VisualElement` 禁用持久性。有关更多信息，请参阅 View Data 持久性。

USS 类

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

还可以使用检视器中的匹配选择器 (Matching Selectors) 部分或 UI 工具包调试器来查看哪些 USS 选择器在其层级视图的每个级别上影响 VisualElement 的组件。

其他资源

UnsignedIntegerField

InspectorElement

Label

Unity 手册