UXML 元素 SliderInt

SliderInt 允许用户从一系列值中选择一个整数。您可以使用 SliderInt 来调整值，例如游戏中角色的生命值。要设置值，您可以沿着轨道拖动滑块，或点击轨道本身。滑块还可以包含一个文本输入字段允许用户输入文本字符串的字段 更多信息
参见 术语表，您可以在其中直接修改值。

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

创建 SliderInt

您可以使用 UI(用户界面) 允许用户与您的应用程序交互。 Unity 目前支持三种 UI 系统。 更多信息
参见 术语表 生成器、UXML 或 C# 创建 SliderInt。以下 C# 示例创建了一个具有默认值、低值和高值的 SliderInt，并设置了滑块的方向

var sliderInt = new SliderInt();
sliderInt.value = 42;
sliderInt.lowValue = 0;
sliderInt.highValue = 100;
sliderInt.direction = SliderDirection.Horizontal;

设置页面大小

SliderInt 控件有一个页面大小属性，控制您点击滑块两侧的轨道时，滑块的移动距离和值的更改量。

如果页面大小值为 0，则点击轨道会将滑块移动到光标或指针位置，并相应地更新值。

如果页面大小值大于 0，则点击轨道会将滑块按特定量向光标或指针位置移动。SliderInt 控件将页面大小视为绝对值。

例如，如果总范围为 200，页面大小为 20，则页面大小量为 20 的绝对值。每次点击轨道时，滑块都会移动，并且值会增加或减少 20。

示例

以下 UXML 示例创建了一个 SliderInt

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <SliderInt
        label="UXML Slider"
        name="the-uxml-slider"
        low-value="0"
        high-value="100"
        page-size="1"
        value="42" />
</UXML>

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

/// <sample>
// Get a reference to the slider from UXML and assign it its value.
var uxmlSlider = container.Q<SliderInt>("the-uxml-slider");
uxmlSlider.value = 42;

// Create a new slider, disable it, and give it a style class.
var csharpSlider = new SliderInt("C# Slider", 0, 100);
csharpSlider.SetEnabled(false);
csharpSlider.AddToClassList("some-styled-slider");
csharpSlider.value = uxmlSlider.value;
container.Add(csharpSlider);

// Mirror value of uxml slider into the C# field.
uxmlSlider.RegisterCallback<ChangeEvent<int>>((evt) =>
{
    csharpSlider.value = evt.newValue;
});
/// </sample>

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

C# 基类和命名空间

C# 类：SliderInt
命名空间：UnityEngine.UIElements
基类：BaseSlider_1

成员 UXML 属性

此元素具有以下成员属性

继承的 UXML 属性

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

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

USS 类

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

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

其他资源

• UXML 元素 Slider
• UXML 元素 MinMaxSlider