版本:Unity 6 (6000.0)
语言:English
UXML 元素 MaskField
UXML 元素 MultiColumnListView

UXML 元素 MinMaxSlider

MinMaxSlider 元素是一个滑块,允许用户在指定的最小和最大范围之间选择一个值范围。您可以使用它来设置各种参数的值范围,例如音量级别、角色属性或 UI 中的其他数值。UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。更多信息
参见 术语表
。要使用它,请定义最小值和最大值,然后滑动滑块手柄以选择所需的范围。

An example MinMaxSlider control
MinMaxSlider 控件示例

创建 MinMaxSlider

您可以使用 UI Builder、UXML 或 C# 创建 MinMaxSlider。以下 C# 示例创建了一个具有默认值、下限和上限的 MinMaxSlider。

var minMaxSlider = new MinMaxSlider();
minMaxSlider.value = new Vector2(0.25f, 0.75f);
minMaxSlider.lowLimit = 0;
minMaxSlider.highLimit = 1;

注意:要在 Inspector一个 Unity 窗口,显示有关当前选定 GameObject、资源或项目设置的信息,允许您检查和编辑值。更多信息
参见 术语表
窗口中将元素与其他字段对齐,只需应用 .unity-base-field__aligned USS 类即可。有关更多信息,请参阅 BaseField

示例

以下 UXML 示例创建了一个 MinMaxSlider。

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <MinMaxSlider
        label="UXML Field"
        name="the-uxml-field"
        min-value="0"
        max-value="20"
        low-limit="-10"
        high-limit="40" />
</UXML>

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

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<MinMaxSlider>("the-uxml-field");
uxmlField.value = new Vector2(10, 12);

// Create a new field, disable it, and give it a style class.
var csharpField = new MinMaxSlider("C# Field", 0, 20, -10, 40);
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<Vector2>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

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

C# 基类和命名空间

C# 类MinMaxSlider
命名空间UnityEngine.UIElements
基类BaseField_1

成员 UXML 属性

此元素具有以下成员属性

名称 类型 描述
high-limit float 这是滑块的上限。
low-limit float 这是滑块的下限。
value Vector2 这是滑块的值。这是一个 Vector2,其中 x 是下界,y 是上界。

继承的 UXML 属性

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

名称 类型 描述
binding-path string 要绑定的目标属性的路径。
focusable boolean 如果元素可以聚焦,则为真。
label string 表示将在字段旁边显示的标签的字符串。
tabindex int 用于在焦点环中对可聚焦元素进行排序的整数。必须大于或等于零。
value Vector2 与字段关联的值。

此元素还从 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 Asset Store 中提供的可用第三方插件并使用 ITextElementExperimentalFeatures.renderedText
name string 此 VisualElement 的名称。

使用此属性编写针对特定元素的 USS 选择器。标准做法是为元素提供唯一的名称。
picking-mode UIElements.PickingMode 确定在鼠标事件或 IPanel.Pick 查询期间是否可以选择此元素。
style string 设置 VisualElement 样式值。
tooltip string 在用户将鼠标悬停在元素上一段时间后,在信息框内显示的文本。这仅在编辑器 UI 中受支持。
usage-hints UIElements.UsageHints 指定 VisualElement 高级预期使用模式的提示值组合。仅当 VisualElement 尚未成为 Panel 的一部分时,才能设置此属性。一旦成为 Panel 的一部分,此属性实际上就成为只读的,尝试更改它将引发异常。正确 UsageHints 的规范驱动系统根据预期的使用模式做出更好的决策,关于如何处理或加速某些操作。请注意,这些提示不会影响行为或视觉结果,只会影响面板及其内部元素的整体性能。建议始终考虑指定正确的 UsageHints,但请记住,在某些情况下,某些 UsageHints 可能会在内部被忽略(例如,由于目标平台上的硬件限制)。
view-data-key string 用于视图数据持久性,例如树展开状态、滚动位置或缩放级别。

此键用于从视图数据存储中保存和加载视图数据。如果您未设置此键,则关联的 VisualElement 的持久性将被禁用。有关更多信息,请参阅 视图数据持久性

USS 类

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

C# 属性 USS 选择器 描述
ussClassName .unity-min-max-slider 此类型元素的 USS 类名称。
labelUssClassName .unity-min-max-slider__label 此类型元素中标签的 USS 类名称。
inputUssClassName .unity-min-max-slider__input 此类型元素中输入元素的 USS 类名称。
trackerUssClassName .unity-min-max-slider__tracker 此类型元素中跟踪器元素的 USS 类名称。
draggerUssClassName .unity-min-max-slider__dragger 此类型元素中拖动器元素的 USS 类名称。
minThumbUssClassName .unity-min-max-slider__min-thumb 此类型元素中最小拇指元素的 USS 类名称。
maxThumbUssClassName .unity-min-max-slider__max-thumb 此类型元素中最大拇指元素的 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 在 Inspector 元素中对齐的元素的 USS 类名称
disabledUssClassName .unity-disabled 本地禁用元素的 USS 类名称。

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

其他资源

UXML 元素 MaskField
UXML 元素 MultiColumnListView