滑动条

UnityEngine.UIElements 中的类

留下反馈

建议更改

描述

包含浮点值的滑块。

滑动条控件是一个水平或垂直的条，带有一个可以移动的手柄，用于从一个范围内选择一个值。范围由 lowValue 和 highValue 属性定义。

滑块以自定义方式管理导航事件。当它检测到与滑块方向一致的 NavigationMoveEvent 时，它会调整滑块的值。如果它检测到 NavigationSubmitEvent，它会从拖动器中移除 BaseSlider_1.movableUssClassName 类，导致所有导航事件恢复为其默认行为。第二个导航提交事件将在拖动器上重新启用 movableUssClassName 类，并恢复之前的自定义行为。

有关更多信息和代码示例，请参考 UXML 元素滑动条手册页。

其他资源: MinMaxSlider

静态属性

inputUssClassName	此类型元素中输入元素的 USS 类名。
labelUssClassName	此类型元素中标签的 USS 类名。
ussClassName	此类型元素的 USS 类名。

构造函数

滑动条	创建一个新的 Slider 实例。

继承的成员

静态属性

alignedFieldUssClassName	在检查器元素中对齐的元素的 USS 类名
labelDraggerVariantUssClassName	此类型元素中标签的 USS 类名，当它们连接到拖动器时。
mixedValueLabelUssClassName	显示混合值的元素的 USS 类名
noLabelVariantUssClassName	此类型元素的 USS 类名，当没有标签时。
dragContainerUssClassName	此类型元素中容器元素的 USS 类名。
draggerBorderUssClassName	此类型元素中拖动器边框元素的 USS 类名。
draggerUssClassName	此类型元素中拖动器元素的 USS 类名。
fillUssClassName	此类型元素中填充元素的 USS 类名。
horizontalVariantUssClassName	此类型元素的 USS 类名，当它们水平显示时。
inputUssClassName	此类型元素中输入元素的 USS 类名。
labelUssClassName	此类型元素中标签的 USS 类名。
movableUssClassName	拖动器上的 USS 类名，表示它当前由 NavigationMoveEvent 控制。当滑块检测到与滑块方向一致的移动事件时，它会调整滑块的值。如果它检测到导航提交事件，它会删除样式，导致所有导航事件恢复为其默认行为。第二个导航提交事件会将样式重新应用到拖动器，并恢复之前的自定义行为。
textFieldClassName	此类型元素中文本字段元素的 USS 类名。
trackerUssClassName	此类型元素中跟踪器元素的 USS 类名。
ussClassName	此类型元素的 USS 类名。
verticalVariantUssClassName	此类型元素的 USS 类名，当它们垂直显示时。
disabledUssClassName	本地禁用元素的 USS 类名。

属性

label	表示将出现在字段旁边的标签的字符串。
labelElement	这是出现在字段输入旁边的 Label 对象。
mixedValueLabel	只读标签，用于显示编辑多个不同值的样式。
rawValue	元素的值。
showMixedValue	设置为 true 时，将为字段提供编辑多个不同值的样式。
direction	这是包含滑块方向的实际属性。
fill	启用填充以设置滑块的颜色和形状。
highValue	这是滑块编码的最大值。
inverted	这表示此滑块是否反转。对于反转的水平滑块，高值位于左侧，低值位于右侧。对于反转的垂直滑块，高值位于底部，低值位于顶部。
lowValue	这是滑块编码的最小值。
pageSize	表示在滚动滑块时应应用于计算的滚动偏移量的值，例如在轨道内点击或点击滑块箭头。
range	这是滑块的最小值到最大值的范围。
showInputField	滑块控件中可选字段的可见性。
value	滑块的实际值。
binding	将被更新的绑定对象。
bindingPath	要绑定的目标属性的路径。
canGrabFocus	如果元素可以获得焦点，则返回 true。
delegatesFocus	元素是否应将焦点委托给其子元素。
focusable	如果元素可以获得焦点，则为 true。
focusController	返回此元素的焦点控制器。
tabIndex	用于在焦点环中对可获得焦点的元素进行排序的整数。必须大于或等于零。
childCount	此对象 contentContainer 中的子元素数量。
contentContainer	子元素将被添加到其中，通常与元素本身相同。
contentRect	元素内容区域的矩形，在元素的局部空间中。（只读）
customStyle	VisualElement 的自定义样式属性访问器。（只读）
dataSource	将数据源分配给此 VisualElement，覆盖任何继承的数据源。此数据源由所有子元素继承。
dataSourcePath	从数据源到值的路径。
dataSourceType	可以分配给此 VisualElement 的数据源的可能类型。此信息仅供 UI Builder 使用，作为提示，以便在设计时无法指定有效数据源时，为数据源路径字段提供一些完成。
disablePlayModeTint	除非设置为 true，否则默认情况下会应用播放模式色调。它会按层次结构应用于此 VisualElement 及其在编辑器面板上存在的子元素。
enabledInHierarchy	如果 VisualElement 在其自己的层次结构中启用，则返回 true。
enabledSelf	如果 VisualElement 在本地启用，则返回 true。
experimental	返回 UIElements 实验接口。
generateVisualContent	用于生成视觉元素的视觉内容的委托函数。
hierarchy	访问此元素的物理层次结构
languageDirection	指示元素文本的方向。该值将传播到元素的子元素。
layout	VisualElement 相对于其父元素的位置和大小，由布局系统计算。（只读）
localBound	返回一个 Rect，表示应用变换后但应用布局平移之前的轴对齐包围盒 (AABB)。
name	此 VisualElement 的名称。
paddingRect	元素填充区域的矩形，在元素的局部空间中。
panel	此 VisualElement 附加到的面板。
parent	此 VisualElement 的父元素。
pickingMode	确定此元素是否可以在 mouseEvents 或 IPanel.Pick 查询期间被选中。
resolvedStyle	视觉元素的最终渲染样式值，如当前帧中渲染的那样。（只读）
scaledPixelsPerPoint	返回面板的缩放结果，该面板考虑了屏幕 DPI 和可自定义的缩放因子，但不考虑元素及其祖先的变换比例。请参阅 Panel.scaledPixelsPerPoint。这应该只对面板的一部分元素调用。
schedule	检索此 VisualElement 的 IVisualElementScheduler
style	在 VisualElement 上设置样式值。
styleSheets	返回一个 VisualElementStyleSheetSet，用于操作附加到此元素的样式表。
this[int]	检索特定索引处的子元素。
tooltip	在用户将鼠标悬停在元素上一段时间后，将在信息框中显示的文本。这仅在编辑器 UI 中受支持。
transform	返回此 VisualElement 的变换对象。ITransform
usageHints	提示值的组合，指定 VisualElement 的高级预期使用模式。此属性只能在 VisualElement 尚未成为 Panel 的一部分时设置。一旦成为 Panel 的一部分，此属性实际上就变为只读，尝试更改它会引发异常。指定正确的 UsageHints 会使系统能够更好地决定如何根据预期的使用模式来处理或加速某些操作。请注意，这些提示不会影响行为或视觉结果，而只会影响面板及其内部元素的整体性能。建议始终考虑指定正确的 UsageHints，但请记住，某些 UsageHints 可能在某些情况下被内部忽略（例如，由于目标平台上的硬件限制）。
userData	此属性可用于将应用程序特定的用户数据与此 VisualElement 关联。
viewDataKey	用于视图数据持久性，例如树展开状态、滚动位置或缩放级别。
visible	指示此元素是否应该被渲染。
visualTreeAssetSource	存储资产引用，如果生成的元素是从 VisualTreeAsset 克隆的。
worldBound	返回一个 Rect，表示应用世界变换后的轴对齐包围盒 (AABB)。
worldTransform	返回一个矩阵，累积以下操作（按顺序）：- 局部缩放 - 局部旋转 - 局部平移 - 布局平移 - 父世界变换（递归定义 - 当没有父元素时，考虑单位矩阵）

公共方法

SetValueWithoutNotify	允许设置值，而不会收到有关更改的通知（如果有）。
AdjustDragElement	用于调整拖动元素的方法。主要用于滚动器。
ApplyInputDeviceDelta	当用户拖动标签以更新字段中包含的值时调用。
HasBubbleUpHandlers	如果事件传播的 BubbleUp 阶段的事件处理程序已附加到此对象，则返回 true。
HasTrickleDownHandlers	如果事件传播的 TrickleDown 阶段的事件处理程序已附加到此对象，则返回 true。
RegisterCallback	向实例添加事件处理程序。如果事件处理程序已为同一阶段（TrickleDown 或 BubbleUp）注册，则此方法无效。
RegisterCallbackOnce	向实例添加事件处理程序。如果事件处理程序已为同一阶段（TrickleDown 或 BubbleUp）注册，则此方法无效。事件处理程序在恰好被调用一次后会自动取消注册。
UnregisterCallback	从实例中删除回调。
Blur	告诉元素释放焦点。
Focus	尝试将焦点赋予此元素。
Add	将元素添加到此元素的 contentContainer 中。
AddToClassList	向元素的类列表中添加一个类，以便从 USS 中分配样式。请注意，类名区分大小写。
BringToFront	将此元素移至其父级子级列表的末尾。该元素将在视觉上位于任何重叠的兄弟元素的前面。
Children	返回来自其 contentContainer 的元素。
ClassListContains	在该元素的类列表中搜索一个类。
Clear	从该元素的 contentContainer 中删除所有子级元素。
ClearBinding	从元素中删除绑定。
ClearBindings	从元素中删除所有绑定。
ClearClassList	从该元素的类列表中删除所有类。AddToClassList
Contains	检查该元素是否是指定子级元素的祖先。
ContainsPoint	检查指定点是否与该 VisualElement 的布局相交。
ElementAt	检索特定索引处的子元素。
EnableInClassList	启用或禁用具有给定名称的类。
FindAncestorUserData	向上搜索该 VisualElement 的层次结构并检索存储的 userData（如果有）。
FindCommonAncestor	在 VisualTree 层次结构中查找两个 VisualElements 之间的最低共同祖先。
GetBinding	获取为提供的目标属性提供的绑定实例。
GetBindingInfos	获取有关当前元素的所有绑定的信息。
GetClasses	检索该元素的类。
GetDataSourceContext	查询绑定对象的 dataSource 和 dataSourcePath。
GetFirstAncestorOfType	从该元素的父级开始向上遍历层次结构，并返回此类型的第一个 VisualElement。
GetFirstOfType	从该元素开始向上遍历层次结构，并返回此类型的第一个 VisualElement。
GetHierarchicalDataSourceContext	查询从层次结构继承的 dataSource 和 dataSourcePath。
HasBinding	允许知道目标属性是否与其关联了一个绑定。
IndexOf	检索指定 VisualElement 的子级索引。
Insert	将元素插入到该元素的 contentContainer 中。
MarkDirtyRepaint	在下一帧触发 VisualElement 的重绘。当发生需要重绘的更改时，此方法会在内部调用，例如当 UIElements.BaseField_1.value 更改或 Label 中的文本更改时。如果正在实现自定义控件，则可以调用此方法以在发生需要重绘的更改时触发重绘，例如在使用 generateVisualContent 渲染网格且网格数据现在已更改时。
PlaceBehind	将该元素放在其父级子级列表中兄弟元素的正前方。如果元素和兄弟元素的位置重叠，则该元素将在视觉上位于其兄弟元素的后面。
PlaceInFront	将该元素放在其父级子级列表中兄弟元素的正后方。如果元素和兄弟元素的位置重叠，则该元素将在视觉上位于其兄弟元素的前面。
Remove	从 contentContainer 层次结构中删除该子级。
RemoveAt	从该元素的 contentContainer 中删除位于该位置的子级元素。
RemoveFromClassList	从元素的类列表中删除一个类。
RemoveFromHierarchy	从其父级层次结构中删除该元素。
SendEvent	将事件发送到事件处理程序。
SendToBack	将该元素发送到其父级子级列表的开头。该元素将在视觉上位于任何重叠的兄弟元素的后面。
SetBinding	在目标和源之间分配绑定。
SetEnabled	更改 VisualElement 的启用状态。禁用的 VisualElement 不会接收大多数事件。
Sort	重新排序来自该 VisualElement contentContainer 的子级元素。
ToggleInClassList	在向类列表中添加和删除给定类名之间切换。
TryGetBinding	获取为提供的目标属性提供的绑定实例。
TryGetDataSourceContext	查询绑定对象的 dataSource 和 dataSourcePath。
TryGetLastBindingToSourceResult	返回从 UI 到数据源的绑定对象的最后一个 BindingResult。
TryGetLastBindingToUIResult	返回从数据源到 UI 的绑定对象的最后一个 BindingResult。

受保护的方法

UpdateMixedValueContent	根据 showMixedValue 更新字段的视觉内容。
HandleEventBubbleUp	在 BubbleUp 阶段的该元素上执行逻辑，就在该元素的 BubbleUp 回调之前。调用 StopPropagation 将阻止在传播路径上进一步调用此方法。
HandleEventTrickleDown	在 TrickleDown 阶段的该元素上执行逻辑，就在该元素的 TrickleDown 回调之后。调用 StopPropagation 将阻止在传播路径上进一步调用此方法。
NotifyPropertyChanged	通知数据绑定系统控件的某个属性已更改。

此处描述的某些内容是否无法按预期工作？这可能是已知问题。请在以下位置查看问题跟踪器 issuetracker.unity3d.com.

脚本 API

滑动条

成功！

提交失败

描述

静态属性

构造函数

继承的成员

静态属性

属性

公共方法

受保护的方法