包含此页的版本:
不含此页的版本:
Hash128Field 允许用户在 UI 中输入 Hash128 值。
注意:要将元素与检查器一个 Unity 窗口,显示有关当前选定游戏对象、资产或项目设置的信息,允许您检查和编辑值。更多信息
请参阅术语表窗口,只需将.unity-base-field__alignedUSS 级。有关更多信息,请参阅BaseField.
你可以使用 UI Builder、UXML 或 C# 创建 Hash128Field。以下 C# 示例创建具有 Hash128 值的 Hash128Field:
var hash128Field = new Hash128Field();
hash128Field.label = "Label text:";
hash128Field.value = new Hash128(0x8f14e45f, 0xceea167a, 0x5a36dedd, 0x4bea2543);
C# 类:Hash128Field
命名空间:UnityEngine.UIElements
基类:TextInputBaseField_1
此元素从其基类继承以下属性:
| 名字 | 类型 | 描述 |
|---|---|---|
auto-correction |
boolean |
确定触摸屏键盘自动校正是打开还是关闭。 |
binding-path |
string |
要绑定的目标属性的路径。 |
emoji-fallback-support |
boolean |
指定系统在呈现文本时查找表情符号字符的顺序。如果启用此设置,则将首先在全局表情符号回退列表中搜索在 Unicode 14.0 标准中定义为表情符号的字符。 |
focusable |
boolean |
如果为 false,则阻止对元素进行聚焦。 仅当元素的 canGrabFocus 属性为 true 时,才能对元素进行聚焦。 |
hide-mobile-input |
boolean |
隐藏或显示移动输入字段。 |
hide-placeholder-on-focus |
boolean |
隐藏焦点上的占位符。 |
is-delayed |
boolean |
如果设置为 true,则在用户按 Enter 或文本字段失去焦点之前,不会更新 value 属性。 |
keyboard-type |
TouchScreenKeyboardType |
将使用的移动键盘类型。 |
label |
string |
表示将显示在字段旁边的标签的字符串。如果字符串为空,则标签元素将从层次结构中删除。如果字符串不为空,则标签元素将添加到层次结构中。 |
mask-character |
System.Char |
用于在密码字段中屏蔽的字符。 |
max-length |
int |
字段的最大字符数。 |
password |
boolean |
如果该字段用于编辑密码,则返回 true。 |
placeholder-text |
string |
一个简短的提示,帮助用户了解要在字段中输入的内容。 |
readonly |
boolean |
如果字段为只读,则返回 true。 |
select-all-on-focus |
boolean |
控制在接收焦点时是否选择元素的内容。 |
select-all-on-mouse-up |
boolean |
控制首次向上鼠标时是否选择元素的内容。 |
select-line-by-triple-click |
boolean |
控制三次单击是否选择鼠标指针下的整行。 |
select-word-by-double-click |
boolean |
控制是否双击选择鼠标指针下的单词。 |
tabindex |
int |
用于对焦点环中的可聚焦元素进行排序的整数。必须大于或等于零。 将 tabIndex值小于0(例如,−1) 从焦点环和选项卡导航中删除元素。 |
value |
Hash128 |
与字段关联的值。 |
vertical-scroller-visibility |
UIElements.ScrollerVisibility |
用于控制垂直滚动条可见性的选项TextInputBaseField_1. |
此元素还继承了以下属性VisualElement:
| 名字 | 类型 | 描述 |
|---|---|---|
content-container |
string |
添加子元素的逻辑容器。如果将子元素添加到此元素,则将子元素添加到该元素的内容容器中。 当迭代 VisualElement.Children元素的元素,则使用元素的内容容器层次结构而不是元素本身。这可能会导致意外结果,例如,如果元素不直接位于内容容器的层次结构中,则导航事件会忽略元素。 指IFocusRing了解更多信息。如果内容容器与元素本身相同,则子元素将直接添加到元素中。对于大多数元素来说都是如此,但可以被更复杂的类型覆盖。 这 ScrollView例如,具有与自身不同的内容容器。在这种情况下,添加到滚动视图的子元素将改为添加到其内容容器元素中。虽然物理父级 (VisualElement.Hierarchy.parent) 是滚动视图的内容容器元素,它们的逻辑父元素 (VisualElement.parent) 仍然引用滚动视图本身。由于滚动视图的一些可聚焦子项不是其逻辑层次结构的一部分,例如Scroller元素,在使用顺序导航时,默认情况下不考虑这些可聚焦的子项。如果默认导航规则与您的需求不符,请参阅如何更改接下来关注的元素,了解解决方法解决方案的示例。 |
data-source |
Object |
将数据源分配给此 VisualElement,该 VisualElement 将替代任何继承的数据源。此数据源由所有子级继承。 |
data-source-path |
string |
从数据源到值的路径。 |
data-source-type |
System.Type |
可分配给此 VisualElement 的可能数据源类型。 当设计时无法指定有效数据源时,UI 生成器仅将 此信息用作提示,以对数据源路径字段进行一些补全。 |
enabled |
boolean |
如果VisualElement在本地启用。如果 VisualElement 的父级之一隐式禁用,则 不会更改此标志。要验证这一点,请使用 enabledInHierarchy. |
language-direction |
UIElements.LanguageDirection |
指示元素文本的方向性。该值将传播到元素的子项。 设置 languageDirection自RTL只能获得文本反转等基本的 RTL 支持。要获得更全面的 RTL 支持,例如换行、自动换行或文本整形,您必须启用高级文本生成器。 |
name |
string |
此 VisualElement 的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。 |
picking-mode |
UIElements.PickingMode |
确定此元素是可以作为指针事件的目标还是由IPanel.Pick查询。如果出现以下情况,则无法拾取元素: - 它们不可见- 它们的 style.display设置为DisplayStyle.None拾取模式为 PickingMode.Ignore永远不要接收悬停伪状态。 |
style |
string |
在VisualElement.返回 的样式数据是根据 USS 文件或在 C# 中写入此对象的内联样式计算得出的,不表示完全解析的样式,例如 VisualElement 的最终高度和宽度。要访问这些完全解析的样式,请使用 resolvedStyle.有关如何使用此属性和所有受支持的 USS 属性的信息,请参阅在 C# 脚本中应用样式和 USS 属性参考手册页。 |
tooltip |
string |
用户将鼠标悬停在元素上一小段时间后,要在信息框内显示的文本。这仅在编辑器UI中受支持。 |
usage-hints |
UIElements.UsageHints |
提示值的组合,用于指定VisualElement.只有当VisualElement还不是Panel.曾经是Panel,则此属性实际上变为只读,尝试更改它将引发异常。适当的规范UsageHints驱动系统根据预期的使用模式就如何处理或加速某些作做出更好的决策。请注意,这些提示不会影响行为或视觉结果,而只会影响面板和其中元素的整体性能。建议始终考虑指定适当的UsageHints,但请记住,某些UsageHints在某些情况下(例如,由于目标平台上的硬件限制),可能会在内部忽略。 |
view-data-key |
string |
用于视图数据持久性,例如树展开状态、滚动位置或缩放级别。 此键用于从视图数据存储中保存和加载视图数据。如果未设置此键,则会禁用关联的持久性 VisualElement.有关更多信息,请参阅 Unity 手册中的查看数据持久性。 |
下表列出了所有 C# 公共属性名称及其相关的 USS 选择器。
| C# 属性 | USS 选择器 | 描述 |
|---|---|---|
ussClassName |
.unity-hash128-field |
此类元素的 USS 级名称。 |
labelUssClassName |
.unity-hash128-field__label |
USS 此类元素中标签的名称。 |
inputUssClassName |
.unity-hash128-field__input |
此类元素中输入元素的 USS 类名称。 |
ussClassName |
.unity-base-text-field |
此类元素的 USS 级名称。 |
labelUssClassName |
.unity-base-text-field__label |
USS 此类元素中标签的名称。 |
inputUssClassName |
.unity-base-text-field__input |
此类元素中输入元素的 USS 类名称。 |
singleLineInputUssClassName |
.unity-base-text-field__input--single-line |
此类元素中单行输入元素的 USS 类名称。 |
multilineInputUssClassName |
.unity-base-text-field__input--multiline |
USS 类名称 此类元素中多行输入元素。 |
placeholderUssClassName |
.unity-base-text-field__input--placeholder |
显示占位符文本时输入元素的 USS 类名称 |
ussClassName |
.unity-base-field |
此类元素的 USS 级名称。 |
labelUssClassName |
.unity-base-field__label |
USS 此类元素中标签的名称。 |
inputUssClassName |
.unity-base-field__input |
此类元素中输入元素的 USS 类名称。 |
noLabelVariantUssClassName |
.unity-base-field--no-label |
当没有标签时,这种类型的元素的 USS 类名称。 |
labelDraggerVariantUssClassName |
.unity-base-field__label--with-dragger |
USS 类名称 标签的此类元素,当它们上附加了拖动器时。 |
mixedValueLabelUssClassName |
.unity-base-field__label--mixed-value |
显示混合值的元素的 USS 级名称 |
alignedFieldUssClassName |
.unity-base-field__aligned |
在检查器元素中对齐的元素的 USS 类名称 |
disabledUssClassName |
.unity-disabled |
本地禁用元素的 USS 级名称。 |
您还可以使用 Inspector 或 UI Toolkit Debugger 中的 Matching Selectors 部分来查看哪些 USS 选择器会影响VisualElement在其层次结构的各个层面。