类参考
UDreamScrollBox
UDreamScrollBox
继承自 UDreamUIControl。
声明于 Public/Controls/DreamScrollBox.h。
一个层级结构由代码而非资产构成的滚动框。
三个节点加一条滚动条:承载滚动框外观的面板、在其内部被裁剪并承载滚动行为的视口,以及在视口内滑动的内容堆叠。它正是下拉列表的布局——在一个裁剪节点上放置 UUIScrollView,其下再放一个被滚动的列——只不过被泛化到任何人都可以向该列填充内容。
BP_HorizontalScrollView 和 BP_VerticalScrollView 是两个资产,因为资产无法根据属性进行分支。方向就是分支点:它决定滚动的轴、内容堆叠的方向,以及滚动条位于哪一侧。刻意不设第三种“两者兼顾”的情况——并不存在这样的预设,内容堆叠只有一个方向,而一个轴意味着一条滚动条,它才能真正触及全部内容。
滚动条是真正的 UDreamScrollBar,而不是在此重新构建的轨道加手柄,因此锚点解析规则所决定的手柄几何只存在一份。滚动框只告诉它要跟随哪个视图;双向链接存在于滚动条之中。
属性
| 名称 | 类型 | 类别 | 在细节面板中 | 来自蓝图 | 说明 |
|---|---|---|---|---|---|
Style | FDreamScrollBoxStyle | Scroll Box | yes | GetStyle / SetStyle | 此实例自身的样式。当 StyleSource 如此指定且项目中确实存在样式表时,项目样式表优先;如果项目中没有样式表,那么这就是实际生效的样式——这正是它保持可编辑而不用枚举值进行限制的原因。 |
Orientation | EDreamPanelOrientation | Scroll Box | yes | GetOrientation / SetOrientation | 它的滚动方向,以及内容的堆叠方向。用一个属性替代两个蓝图资产。 |
bShowScrollBar | bool | Scroll Box | yes | GetShowScrollBar / SetShowScrollBar | 关闭表示完全没有滚动条,视口会保留本应由滚动条占用的间距。 |
ScrollBarVisibility | EDreamScrollBoxScrollbarVisibility | Scroll Box | yes | GetScrollBarVisibility / SetScrollBarVisibility | 当内容已经容纳得下时,滚动条是保持原位还是消失。AutoHide 在运行时跟随内容:每一次重新测量(AddContent、RefreshContentExtent、调整尺寸)都会再次询问,因此一个开始或停止溢出的滚动框会显示或收起它的滚动条,与 UMG 的行为一致——当没有内容滚动时,滚动条及其间距都会折叠。Hidden 从不绘制滚动条,但在有内容可滚动时保留其间距,就像 Hidden 状态的 Slate 滚动条保留其槽位一样;Permanent 对应 UMG 的 AlwaysShowScrollbar。 |
ScrollSensitivity | float | Scroll Box | yes | GetScrollSensitivity / SetScrollSensitivity | 每档鼠标滚轮移动的本地单位数。它过去被文档描述为一个乘数,并被直接推入一个会将原始轴值乘以它的视图,因此默认值 1 会让内容每档只移动一个单位——一个肉眼看起来毫无作用的滚轮。40 是 UDreamLayoutContainerScrollBox 对同一手势已经使用的值。 |
DecelerateRate | float | Scroll Box | yes | GetDecelerateRate / SetDecelerateRate | 一次滑动停止的快慢。零表示永不减速;数值越大停止越快。 |
bAnimateWheelScrolling | bool | Scroll Box | yes | GetAnimateWheelScrolling / SetAnimateWheelScrolling | 滚轮档位会平滑滑动而非瞬间跳转——即 UMG 的 AnimateWheelScrolling。默认关闭,这也是所有现有滚动框已有的行为。 |
WheelScrollAnimationDuration | float | Scroll Box | yes | GetWheelScrollAnimationDuration / SetWheelScrollAnimationDuration | 一次动画档位所需的时间。当 bAnimateWheelScrolling 关闭时被忽略。 |
WheelScrollMultiplier | float | Scroll Box | yes | GetWheelScrollMultiplier / SetWheelScrollMultiplier | 对一档滚轮已经移动的距离施加的普通乘数——沿用 UMG 的命名,列表控件也如此,因此三者保持一致。 |
ConsumeMouseWheel | EDreamScrollBoxConsumeMouseWheel | Scroll Box | yes | GetConsumeMouseWheel / SetConsumeMouseWheel | 滚轮是在此处被吞掉,还是在达到极限时交给外层的可滚动祖先节点处理。 |
bAlwaysShowScrollbarTrack | bool | Scroll Box | yes | IsAlwaysShowScrollbarTrack / SetAlwaysShowScrollbarTrack | 当滚动条空闲时是否绘制其轨道——即 UMG 的 AlwaysShowScrollbarTrack,它将空闲轨道从不可见提升到其一半的透明度(SScrollBar::GetTrackOpacity)。无论此项如何设置,悬停或拖动滚动条时轨道都以完全不透明度绘制,而 Permanent 会将空闲轨道以一半透明度绘制。 |
bAllowOverscroll | bool | Scroll Box | yes | GetAllowOverscroll / SetAllowOverscroll | 允许内容被拉过端点后弹回——即 UMG 的 AllowOverscroll。 |
bBackPadScrolling | bool | Scroll Box | yes | GetBackPadScrolling / SetBackPadScrolling | 在内容之前留出一整个窗口大小的空白,使第一个项目可以一直滚动到尾部边缘——即 UMG 的 BackPadScrolling。是一整个窗口,而不是半个,这是 Slate 的算法。 |
bFrontPadScrolling | bool | Scroll Box | yes | GetFrontPadScrolling / SetFrontPadScrolling | 在内容之后留出一整个窗口大小的空白——即 UMG 的 FrontPadScrolling。 |
bEnableTouchScrolling | bool | Scroll Box | yes | GetEnableTouchScrolling / SetEnableTouchScrolling | 触摸拖动是否滚动此滚动框——即 UMG 的 bEnableTouchScrolling。鼠标拖动不受影响。 |
bAllowRightClickDragScrolling | bool | Scroll Box | yes | GetAllowRightClickDragScrolling / SetAllowRightClickDragScrolling | 用右键拖动是否滚动它——即 UMG 的 bAllowRightClickDragScrolling。拖动从按下时开始滚动,包括跨过拖动阈值的移动,与 SScrollBox 的行为一致,因此内容会一直保持在抓住它的指针下方。仅限内容之上:从滚动框自身滚动条上开始的右键拖动属于滚动条,而滚动条只响应左键(参见 UDreamScrollBar::AcceptedMouseButtons),因此它什么也不会滚动。 |
bConsumePointerInput | bool | Scroll Box | yes | GetConsumePointerInput / SetConsumePointerInput | 此滚动框已处理的指针事件是否被吞掉——即 UMG 的 bConsumePointerInput。关闭则让它传递给滚动框之后绘制的任何内容。 |
AnalogMouseWheelKey | FKey | Scroll Box | yes | GetAnalogMouseWheelKey / SetAnalogMouseWheelKey | 充当此滚动框鼠标滚轮的模拟按键——即 UMG 的 AnalogMouseWheelKey。Invalid(默认值)表示“输入预设已经路由到这里的任何按键”,即右摇杆,因此与所有现有滚动框的行为完全一致。 |
ScrollWhenFocusChanges | EDreamUIScrollWhenFocusChanges | Scroll Box | yes | GetScrollWhenFocusChanges / SetScrollWhenFocusChanges | 当用户焦点落在其内部时此滚动框的行为——即 UMG 的 ScrollWhenFocusChanges。 |
NavigationDestination | EDreamUIScrollDestination | Scroll Box | yes | GetNavigationDestination / SetNavigationDestination | 通过导航显现的控件最终停留的位置——即 UMG 的 NavigationDestination。IntoView 移动显示它所需的最小距离;另外两个总是以相同方式为其取景。 |
NavigationScrollPadding | float | Scroll Box | yes | GetNavigationScrollPadding / SetNavigationScrollPadding | 在其周围保持多宽的窗口留白——即 UMG 的 NavigationScrollPadding。 |
ScrollProgress | float | Scroll Box | yes | GetScrollProgress / SetScrollProgress | 沿滚动轴的位置,从 0 到 1。向内编写;是行为输出的镜像,因此 .dui 绑定和设计师都能看到它。 |
FaceNode | TObjectPtr<UDreamWidget> | Scroll Box | - | read only | |
ViewportNode | TObjectPtr<UDreamWidget> | Scroll Box | - | read only | |
ContentNode | TObjectPtr<UDreamWidget> | Scroll Box | - | read only | |
ScrollBarNode | TObjectPtr<UDreamScrollBar> | Scroll Box | - | read only | |
ScrollView | TObjectPtr<UUIScrollView> | Scroll Box | - | read only | |
ContentStack | TObjectPtr<UDreamLayoutContainerStackBox> | 滚动框 | - | 只读 |
函数
| 函数 | 类型 | 描述 |
|---|---|---|
bool AddContent(UDreamWidget* InWidget) | 可调用 | 将一个控件放入内容堆栈并重新测量。 |
void EndInertialScrolling() | 可调用 | 停止甩动,保持当前位置——对应 UMG 的 EndInertialScrolling。 |
bool GetAllowOverscroll() | 纯函数 | 获取允许过度滚动 |
bool GetAllowRightClickDragScrolling() | 纯函数 | 获取允许右键拖拽滚动 |
FKey GetAnalogMouseWheelKey() | 纯函数 | 获取模拟鼠标滚轮按键 |
bool GetAnimateWheelScrolling() | 纯函数 | UMG 滚动框提供的四个滚动命令,转发给行为对象。 |
bool GetBackPadScrolling() | 纯函数 | 获取后部填充滚动 |
EDreamScrollBoxConsumeMouseWheel GetConsumeMouseWheel() | 纯函数 | 获取消费鼠标滚轮 |
bool GetConsumePointerInput() | 纯函数 | 获取消费指针输入 |
UDreamWidget* GetContentNode() | 纯函数 | 内容的去向。将控件挂载到此节点下,或使用 AddContent,堆栈会按顺序将它们堆叠起来。 |
float GetDecelerateRate() | 纯函数 | 获取减速率 |
bool GetEnableTouchScrolling() | 纯函数 | 获取启用触摸滚动 |
bool GetFrontPadScrolling() | 纯函数 | 获取前部填充滚动 |
bool GetIsScrolling() | 纯函数 | 当动量、回弹或滑行(动画揭示或滚轮刻度)仍在使内容移动时为 true。 |
EDreamUIScrollDestination GetNavigationDestination() | 纯函数 | 获取导航目的地 |
float GetNavigationScrollPadding() | 纯函数 | 获取导航滚动内边距 |
EDreamPanelOrientation GetOrientation() | 纯函数 | 获取方向 |
float GetOverscrollOffset() | 纯函数 | 越过末端的带符号距离,以本地单位计;在范围内时为零,关闭过度滚动时也为零。 |
float GetOverscrollPercentage() | 纯函数 | 同一距离占窗口的百分比——对应 UMG 的 GetOverscrollPercentage。 |
FMargin GetScrollbarPadding() | 纯函数 | 滚动条周围的外边距。与厚度采用相同的安排:由样式持有。 |
float GetScrollbarThickness() | 纯函数 | 滚动条的厚度,以本地单位计。它是样式的读取器而非第二份副本:该数值存于 FDreamScrollBarStyle::Thickness,因为它是滚动条绘制的依据,而在控件层级另设字段则等于把同一测量值写两遍。 |
EDreamScrollBoxScrollbarVisibility GetScrollBarVisibility() | 纯函数 | 获取滚动条可见性 |
float GetScrollOffset() | 纯函数 | 窗口从内容起始边缘起已移动的距离,以本地单位计。 |
float GetScrollOffsetOfEnd() | 纯函数 | 内容 END(末端)进入视图时的偏移量:即整个可滚动范围。 |
float GetScrollProgress() | 纯函数 | 获取滚动进度 |
float GetScrollSensitivity() | 纯函数 | 获取滚动灵敏度 |
UUIScrollView* GetScrollView() | 纯函数 | 行为对象,用于此控件未包装的任何功能——ScrollTo、惯性、第二个滚动条。 |
EDreamUIScrollWhenFocusChanges GetScrollWhenFocusChanges() | 纯函数 | 获取焦点变化时滚动 |
bool GetShowScrollBar() | 纯函数 | 获取显示滚动条 |
FDreamScrollBoxStyle GetStyle() | 纯函数 | 按值返回而非按引用:UFUNCTION 的返回值必须是值类型,而样式是一个小型结构体。 |
float GetViewFraction() | 纯函数 | 当前可见内容的比例,0..1。当所有内容都适合显示时为 1。 |
float GetViewOffsetFraction() | 纯函数 | 窗口在可滚动范围内所处的位置,0..1。当无法滚动时为零。 |
float GetWheelScrollAnimationDuration() | 纯函数 | 获取滚轮滚动动画时长 |
float GetWheelScrollMultiplier() | 纯函数 | 获取滚轮滚动倍数 |
bool IsAlwaysShowScrollbar() | 纯函数 | 当没有可滚动内容时滚动条是否保持显示——对应 UMG 的 AlwaysShowScrollbar。 |
bool IsAlwaysShowScrollbarTrack() | 纯函数 | 是否始终显示滚动条轨道 |
void RefreshContentExtent() | 可调用 | 从堆栈重新获取内容的范围并告知行为对象其范围已变化——当这改变了是否有内容溢出时,将自动隐藏的滚动条显示或收起。 |
void ScrollToEnd() | 可调用 | 滚动到末端 |
void ScrollToStart() | 可调用 | 滚动到起始端 |
bool ScrollWidgetIntoView(UDreamWidget* InWidget, bool bInAnimate, EDreamUIScrollDestination InDestination, float InPadding) | 可调用 | 以最小距离滚动使 InWidget 完全进入视图;若已在视图中则不滚动。 |
void SetAllowOverscroll(bool bInAllow) | 可调用 | 设置允许过度滚动 |
void SetAllowRightClickDragScrolling(bool bInAllow) | 可调用 | 设置允许右键拖拽滚动 |
void SetAlwaysShowScrollbar(bool bInAlwaysShow) | 可调用 | 设置始终显示滚动条 |
void SetAlwaysShowScrollbarTrack(bool bInAlwaysShow) | 可调用 | 设置始终显示滚动条轨道 |
void SetAnalogMouseWheelKey(FKey InKey) | 可调用 | 设置模拟鼠标滚轮按键 |
void SetAnimateWheelScrolling(bool bInAnimate) | 可调用 | 设置动画滚轮滚动 |
void SetBackPadScrolling(bool bInPad) | 可调用 | 改变可滚动的距离,因此重新声明范围并重新测量滚动条。 |
void SetConsumeMouseWheel(EDreamScrollBoxConsumeMouseWheel InConsume) | 可调用 | 设置消费鼠标滚轮 |
void SetConsumePointerInput(bool bInConsume) | 可调用 | 设置消费指针输入 |
void SetDecelerateRate(float InRate) | 可调用 | 设置减速率 |
void SetEnableTouchScrolling(bool bInEnable) | 可调用 | 设置启用触摸滚动 |
void SetFrontPadScrolling(bool bInPad) | 可调用 | 设置前部填充滚动 |
void SetNavigationDestination(EDreamUIScrollDestination InDestination) | 可调用 | 设置导航目的地 |
void SetNavigationScrollPadding(float InPadding) | 可调用 | 设置导航滚动内边距 |
void SetOrientation(EDreamPanelOrientation InOrientation) | 可调用 | 在视图、堆栈和滚动条上重新声明轴向,并重新划分沟槽。 |
void SetScrollbarPadding(FMargin InPadding) | 可调用 | 设置滚动条内边距 |
void SetScrollbarThickness(float InThickness) | 可调用 | 写入 FDreamScrollBarStyle::Thickness 并重新划分沟槽,沟槽正是由它决定的。 |
void SetScrollBarVisibility(EDreamScrollBoxScrollbarVisibility InVisibility) | 可调用 | 设置滚动条可见性 |
void SetScrollOffset(float InOffset) | 可调用 | 钳制到可滚动的最大距离。是 SetScrollProgress 的绝对值对应版本。 |
void SetScrollProgress(float InProgress) | 可调用 | 设置滚动进度 |
void SetScrollSensitivity(float InSensitivity) | 可调用 | 设置滚动灵敏度 |
void SetScrollWhenFocusChanges(EDreamUIScrollWhenFocusChanges InRule) | 可调用 | 设置焦点变化时滚动 |
void SetShowScrollBar(bool bInShowScrollBar) | 可调用 | 设置显示滚动条 |
void SetStyle(FDreamScrollBoxStyle InStyle) | 可调用 | 替换整个外观并重新推送。这是蓝图写入必须走的唯一路径。 |
void SetWheelScrollAnimationDuration(float InDuration) | 可调用 | 设置滚轮滚动动画时长 |
void SetWheelScrollMultiplier(float InMultiplier) | 可调用 | 设置滚轮滚动倍数 |
事件
| 事件 | 签名 | 描述 |
|---|---|---|
OnScrolled | void DreamScrollBoxScrolledEvent__DelegateSignature(float Progress) | 从滚动行为重新广播,因此消费者绑定到控件而非其某个部件。 |
OnUserScrolled | void DreamScrollBoxUserScrolledOffsetEvent__DelegateSignature(float CurrentOffset) | 由 USER(用户)移动——对应 UMG 的 OnUserScrolled,以及其单位,该单位是偏移量而非进度。 |
OnScrollBarVisibilityChanged | void DreamScrollBoxBarVisibilityChangedEvent__DelegateSignature(bool bVisible) | 滚动条出现或消失——对应 UMG 的 OnScrollBarVisibilityChanged。由样式推送触发,那是唯一做决定的地方,且仅当结果实际变化时才触发。 |
OnFocusUpdated | void DreamScrollBoxFocusUpdatedEvent__DelegateSignature(UDreamWidget* FocusedWidget) | 焦点移到框内的某个内容——对应 UMG 的 OnFocusUpdated。 |
OnValueChangedBP | void DreamScrollBoxScrolledEvent__DelegateSignature(float Progress) | <-> 约定:双向绑定会针对这个确切的名称合成其反向路径。滚动框的值就是它滚动到的位置,因此它携带一个值并用 OnScrolled 触发它。 |
与 UMG 的对比
UMG 类中每个面向蓝图的成员,以及它们的去向。adopt:名称相同、含义相同。map:在此处换用其他名称或位于其他类型上。reject:有意缺失,并说明原因。
| UMG | 成员 | 状态 | 此处 | 说明 |
|---|---|---|---|---|
UScrollBox | ScrollAnimationInterpolationSpeed | map | WheelScrollAnimationDuration | 此处的缓动滚动会在固定的 DURATION(持续时间)内平滑移动,而不是以固定速度进行插值,因此调节参数是持续时间。手感相同,参数化方式不同;UDreamLayoutContainerScrollBox 以 UMG 的名称承载基于速度的形式,供布局路径使用。 |
UScrollBox | bEnableTouchScrolling | adopt | bEnableTouchScrolling | 推送到 UUIScrollView::bEnableTouchScrolling;该门控依据事件系统当前的输入设备,因为手指和鼠标都以指针 0 的形式到达。 |
UScrollBox | bConsumePointerInput | adopt | bConsumePointerInput | 一个存储位:UUIScrollView::AllowEventBubbleUp,只是反过来询问。行为上的 Get/SetConsumePointerInput 是它的反向视图。 |
UScrollBox | AnalogMouseWheelKey | adopt | AnalogMouseWheelKey | 默认为无效 = 输入预设路由到这里的任何内容(右摇杆),也就是当前行为。指定按键会缩小范围;该预设只绑定右摇杆的两个轴,因此任何其他按键都需要项目绑定。 |
UScrollBox | bIsFocusable | map | UDreamWidget::bIsFocusable | 已经存在于每个控件的基类上;在此控件上再放一个会遮蔽它(UHT 错误),并成为第二个答案。 |
UScrollBox | WidgetStyle | map | Style | FDreamScrollBoxStyle,根据项目样式表解析。Get/SetStyle。 |
UScrollBox | WidgetBarStyle | map | FDreamScrollBoxStyle::Bar | 盒子的样式承载了滚动条的完整样式,因此一次编辑就能同时装扮盒子和它的滚动条。 |
UScrollBox | Orientation | map | Orientation | 名称和含义相同;类型是 EDreamPanelOrientation 而不是 TEnumAsByte,后者是本库自己的双值写法。 |
UScrollBox | ScrollBarVisibility | map | ScrollBarVisibility | EDreamScrollBoxScrollbarVisibility(Permanent / AutoHide / Hidden)加上 bShowScrollBar 用于“完全不显示滚动条”,而不是 UMG 的 ESlateVisibility。本库没有 Slate 可见性枚举。AutoHide 跟随内容:每次重新测量(AddContent、RefreshContentExtent、调整大小)都会再次询问,因此当内容开始或停止溢出时,滚动条会出现或消失——连同它的留白一起——就像 SScrollBar 那样。Hidden 从不绘制滚动条,并在有内容可滚动时保留其留白,就像隐藏的 Slate 滚动条保留其槽位一样;盒子仍可通过滚轮、拖动和代码滚动。 |
UScrollBox | ConsumeMouseWheel | adopt | ConsumeMouseWheel | EDreamScrollBoxConsumeMouseWheel,同样的三种答案;推送到 UUIScrollView。 |
UScrollBox | ScrollbarThickness | map | FDreamScrollBarStyle::Thickness | 控件上的一对读取/写入方法(Get/SetScrollbarThickness),而不是第二个字段:样式才是唯一真相。使用 float,因为滚动条在其自身轴向上只有一个厚度;UMG 的 FVector2D 写出的第二个数字在这里没有用处。 |
UScrollBox | ScrollbarPadding | map | FDreamScrollBarStyle::BarPadding | 新的样式字段,默认 FMargin(0) = 每个滚动条一直绘制的方式。计入留白,因为留白就是视口为滚动条让出的所有空间。 |
UScrollBox | AlwaysShowScrollbar | map | ScrollBarVisibility | Permanent 就是始终显示,因此 IsAlwaysShowScrollbar / SetAlwaysShowScrollbar 读写的是那个枚举,而不是它旁边的一个标志。 |
UScrollBox | AlwaysShowScrollbarTrack | adopt | bAlwaysShowScrollbarTrack | 只影响空闲轨道的透明度,与 UMG 中一样(SScrollBar::GetTrackOpacity):启用时空闲轨道以一半的 alpha 绘制,不启用时完全不绘制,而悬停或拖动时无论如何都完整绘制;Permanent 时空闲轨道也以一半绘制。当没有任何内容滚动时,它既不保留滚动条也不保留其留白——只有 ScrollBarVisibility 为 Permanent 才会如此。 |
UScrollBox | AllowOverscroll | adopt | bAllowOverscroll | 推送到 UUIScrollView::bAllowOverscroll,它门控越界阻尼器,而不是将作者的数字归零。 |
UScrollBox | BackPadScrolling | adopt | bBackPadScrolling | 一个完整窗口的前置空间,与 Slate 的消耗相同(不是计划草图中所画的半个窗口)。此处可在运行时写入;UMG 的只能构造时设置。 |
UScrollBox | FrontPadScrolling | adopt | bFrontPadScrolling | 一个完整窗口的后置空间。可在运行时写入,不同于 UMG 的。 |
UScrollBox | bAnimateWheelScrolling | adopt | bAnimateWheelScrolling | |
UScrollBox | NavigationDestination | adopt | NavigationDestination | EDreamUIScrollDestination,现在有 BottomOrRight,因此 UMG 的四种答案都存在。 |
UScrollBox | NavigationScrollPadding | adopt | NavigationScrollPadding | 此处可在运行时写入;UMG 的只能构造时设置。 |
UScrollBox | ScrollWhenFocusChanges | adopt | ScrollWhenFocusChanges | 默认为 AnimatedScroll,而不是 UMG 的 NoScroll:此处的导航一直会显示其目标,而 NoScroll 会阻止每个现有的手柄驱动列表跟随焦点。 |
UScrollBox | bAllowRightClickDragScrolling | adopt | bAllowRightClickDragScrolling | 在拖动开始时询问一次,因此被拒绝的手势在其整个过程中都保持被拒绝——并且当没有任何内容可滚动时,无论此项如何设置,右键拖动都会被拒绝,就像 SScrollBox 只在其滚动条 IsNeeded 时才接受拖动一样。拖动从按下时开始滚动,包括越过拖动阈值的移动,就像 SScrollBox 那样,因此内容会停留在抓住它的指针下方。从盒子自己的滚动条上开始的右键拖动不会滚动任何内容:滚动条只响应左键(UDreamScrollBar::AcceptedMouseButtons,SScrollBar 的规则),而拖动内容的视图位于滚动条旁边的视口上,因此该手势两者都到达不了——而在 SScrollBox 中,未被应答的按下会向上冒泡,从而拖动内容。 |
UScrollBox | WheelScrollMultiplier | adopt | WheelScrollMultiplier | 缩放 ScrollSensitivity,即一个刻度覆盖的 DISTANCE(距离)。名称和含义与列表控件的相同。 |
UScrollBox | SetConsumeMouseWheel | adopt | SetConsumeMouseWheel | |
UScrollBox | SetOrientation | adopt | SetOrientation | |
UScrollBox | SetScrollBarVisibility | adopt | SetScrollBarVisibility | |
UScrollBox | SetScrollbarThickness | adopt | SetScrollbarThickness | 接受 float;写入样式并将 StyleSource 切换为 Inline,这样下一次样式推送就不会丢弃该数字。 |
UScrollBox | SetScrollbarPadding | adopt | SetScrollbarPadding | |
UScrollBox | SetAlwaysShowScrollbar | adopt | SetAlwaysShowScrollbar | |
UScrollBox | SetAllowOverscroll | adopt | SetAllowOverscroll | |
UScrollBox | SetAnimateWheelScrolling | adopt | SetAnimateWheelScrolling | |
UScrollBox | SetScrollAnimationInterpolationSpeed | map | SetWheelScrollAnimationDuration | 参见属性行:本库的缓动滚动基于持续时间。 |
UScrollBox | SetWheelScrollMultiplier | adopt | SetWheelScrollMultiplier | |
UScrollBox | GetConsumePointerInput | adopt | GetConsumePointerInput | |
UScrollBox | SetConsumePointerInput | adopt | SetConsumePointerInput | |
UScrollBox | SetScrollWhenFocusChanges | adopt | SetScrollWhenFocusChanges | |
UScrollBox | SetNavigationDestination | adopt | SetNavigationDestination | |
UScrollBox | EndInertialScrolling | adopt | EndInertialScrolling | 丢弃甩动,并让任何张开的橡皮筋弹回闭合,这不是惯性。 |
UScrollBox | GetAnalogMouseWheelKey | adopt | GetAnalogMouseWheelKey | |
UScrollBox | SetAnalogMouseWheelKey | adopt | SetAnalogMouseWheelKey | |
UScrollBox | GetIsFocusable | map | UDreamWidget::GetIsFocusable | 在基类上,与该属性一起。 |
UScrollBox | SetIsFocusable | map | UDreamWidget::SetIsFocusable | 在基类上,与该属性一起。 |
UScrollBox | OnUserScrolled | adopt | OnUserScrolled | 一个偏移量,按 UMG 的上报方式。仅当玩家做出的更改时才触发:此控件自身推送的所有内容都会在推送时刻被标记,而那是两条路径唯一可区分的地方。 |
UScrollBox | OnScrollBarVisibilityChanged | adopt | OnScrollBarVisibilityChanged | 是一个 bool 而不是 ESlateVisibility,本库中没有后者。从样式推送中触发,且仅在发生变化时。 |
UScrollBox | OnFocusReceived | adopt | OnFocusReceived | 该事件是每个控件都已拥有的 UDreamWidget::OnFocusReceived(UserIndex、PointerId);此框添加的是中继,因为事件系统聚焦的是 FACE 而不是控件。一个按需添加到 FACE 并受基类的 bIsFocusable 门控的 UUISelectable,后者默认关闭——因此没有任何现有滚动框成为导航候选。该 selectable 正是事件系统将焦点交给的东西,也是已经能够区分静止指针与焦点的东西,因此它的状态确实会收到和失去;只有 EDGE 会被通告,因为该状态在重绘时也会被重新应用。 |
UScrollBox | OnFocusLost | adopt | OnFocusLost | UDreamWidget::OnFocusLost,从 face 中继而来:同一订阅的另一条边,处于同一门控之下。 |
UScrollBox | OnFocusUpdated | adopt | OnFocusUpdated | 焦点在框内部移动,携带取得焦点的控件。不受 bIsFocusable 门控——无论框是否可聚焦,内容都是可聚焦的。由导航揭示通过 UUIScrollView::NotifyContentFocusMoved 引发:该遍历是唯一一处既知道哪个控件取得了焦点、又知道哪些滚动祖先包含它的地方,而轮询 HasFocusedDescendants 将是为一条边而进行的一次 tick。 |
UScrollBox | SetScrollOffset | adopt | SetScrollOffset | |
UScrollBox | GetScrollOffset | adopt | GetScrollOffset | |
UScrollBox | GetOverscrollOffset | adopt | GetOverscrollOffset | 有符号:起点之前为负,终点之后为正,在范围内为零,且当过度滚动关闭时也为零。 |
UScrollBox | GetOverscrollPercentage | adopt | GetOverscrollPercentage | 窗口的百分比,按 SScrollBox 的上报方式。 |
UScrollBox | GetScrollOffsetOfEnd | adopt | GetScrollOffsetOfEnd | |
UScrollBox | GetViewFraction | adopt | GetViewFraction | |
UScrollBox | GetViewOffsetFraction | adopt | GetViewOffsetFraction | 行为已经维护的进度;不是第二次除法。 |
UScrollBox | ScrollToStart | adopt | ScrollToStart | |
UScrollBox | ScrollToEnd | adopt | ScrollToEnd | |
UScrollBox | ScrollWidgetIntoView | adopt | ScrollWidgetIntoView | 全部四个参数,附加目的地和内边距,以便旧的二参数调用保持其含义:Configured 和负内边距均表示“此框所设置的任何内容”。在 UUIScrollView 和 UDreamLayoutContainerScrollBox 上具有相同的签名。 |
UScrollBox | GetIsScrolling | adopt | GetIsScrolling |