DreamGUI
类参考

UDreamScrollBox

UDreamScrollBox

继承自 UDreamUIControl。

声明于 Public/Controls/DreamScrollBox.h。

一个层级结构由代码而非资产构成的滚动框。

三个节点加一条滚动条:承载滚动框外观的面板、在其内部被裁剪并承载滚动行为的视口,以及在视口内滑动的内容堆叠。它正是下拉列表的布局——在一个裁剪节点上放置 UUIScrollView,其下再放一个被滚动的列——只不过被泛化到任何人都可以向该列填充内容。

BP_HorizontalScrollView 和 BP_VerticalScrollView 是两个资产,因为资产无法根据属性进行分支。方向就是分支点:它决定滚动的轴、内容堆叠的方向,以及滚动条位于哪一侧。刻意不设第三种“两者兼顾”的情况——并不存在这样的预设,内容堆叠只有一个方向,而一个轴意味着一条滚动条,它才能真正触及全部内容。

滚动条是真正的 UDreamScrollBar,而不是在此重新构建的轨道加手柄,因此锚点解析规则所决定的手柄几何只存在一份。滚动框只告诉它要跟随哪个视图;双向链接存在于滚动条之中。

属性

名称类型类别在细节面板中来自蓝图说明
StyleFDreamScrollBoxStyleScroll BoxyesGetStyle / SetStyle此实例自身的样式。当 StyleSource 如此指定且项目中确实存在样式表时,项目样式表优先;如果项目中没有样式表,那么这就是实际生效的样式——这正是它保持可编辑而不用枚举值进行限制的原因。
OrientationEDreamPanelOrientationScroll BoxyesGetOrientation / SetOrientation它的滚动方向,以及内容的堆叠方向。用一个属性替代两个蓝图资产。
bShowScrollBarboolScroll BoxyesGetShowScrollBar / SetShowScrollBar关闭表示完全没有滚动条,视口会保留本应由滚动条占用的间距。
ScrollBarVisibilityEDreamScrollBoxScrollbarVisibilityScroll BoxyesGetScrollBarVisibility / SetScrollBarVisibility当内容已经容纳得下时,滚动条是保持原位还是消失。AutoHide 在运行时跟随内容:每一次重新测量(AddContent、RefreshContentExtent、调整尺寸)都会再次询问,因此一个开始或停止溢出的滚动框会显示或收起它的滚动条,与 UMG 的行为一致——当没有内容滚动时,滚动条及其间距都会折叠。Hidden 从不绘制滚动条,但在有内容可滚动时保留其间距,就像 Hidden 状态的 Slate 滚动条保留其槽位一样;Permanent 对应 UMG 的 AlwaysShowScrollbar。
ScrollSensitivityfloatScroll BoxyesGetScrollSensitivity / SetScrollSensitivity每档鼠标滚轮移动的本地单位数。它过去被文档描述为一个乘数,并被直接推入一个会将原始轴值乘以它的视图,因此默认值 1 会让内容每档只移动一个单位——一个肉眼看起来毫无作用的滚轮。40 是 UDreamLayoutContainerScrollBox 对同一手势已经使用的值。
DecelerateRatefloatScroll BoxyesGetDecelerateRate / SetDecelerateRate一次滑动停止的快慢。零表示永不减速;数值越大停止越快。
bAnimateWheelScrollingboolScroll BoxyesGetAnimateWheelScrolling / SetAnimateWheelScrolling滚轮档位会平滑滑动而非瞬间跳转——即 UMG 的 AnimateWheelScrolling。默认关闭,这也是所有现有滚动框已有的行为。
WheelScrollAnimationDurationfloatScroll BoxyesGetWheelScrollAnimationDuration / SetWheelScrollAnimationDuration一次动画档位所需的时间。当 bAnimateWheelScrolling 关闭时被忽略。
WheelScrollMultiplierfloatScroll BoxyesGetWheelScrollMultiplier / SetWheelScrollMultiplier对一档滚轮已经移动的距离施加的普通乘数——沿用 UMG 的命名,列表控件也如此,因此三者保持一致。
ConsumeMouseWheelEDreamScrollBoxConsumeMouseWheelScroll BoxyesGetConsumeMouseWheel / SetConsumeMouseWheel滚轮是在此处被吞掉,还是在达到极限时交给外层的可滚动祖先节点处理。
bAlwaysShowScrollbarTrackboolScroll BoxyesIsAlwaysShowScrollbarTrack / SetAlwaysShowScrollbarTrack当滚动条空闲时是否绘制其轨道——即 UMG 的 AlwaysShowScrollbarTrack,它将空闲轨道从不可见提升到其一半的透明度(SScrollBar::GetTrackOpacity)。无论此项如何设置,悬停或拖动滚动条时轨道都以完全不透明度绘制,而 Permanent 会将空闲轨道以一半透明度绘制。
bAllowOverscrollboolScroll BoxyesGetAllowOverscroll / SetAllowOverscroll允许内容被拉过端点后弹回——即 UMG 的 AllowOverscroll。
bBackPadScrollingboolScroll BoxyesGetBackPadScrolling / SetBackPadScrolling在内容之前留出一整个窗口大小的空白,使第一个项目可以一直滚动到尾部边缘——即 UMG 的 BackPadScrolling。是一整个窗口,而不是半个,这是 Slate 的算法。
bFrontPadScrollingboolScroll BoxyesGetFrontPadScrolling / SetFrontPadScrolling在内容之后留出一整个窗口大小的空白——即 UMG 的 FrontPadScrolling。
bEnableTouchScrollingboolScroll BoxyesGetEnableTouchScrolling / SetEnableTouchScrolling触摸拖动是否滚动此滚动框——即 UMG 的 bEnableTouchScrolling。鼠标拖动不受影响。
bAllowRightClickDragScrollingboolScroll BoxyesGetAllowRightClickDragScrolling / SetAllowRightClickDragScrolling用右键拖动是否滚动它——即 UMG 的 bAllowRightClickDragScrolling。拖动从按下时开始滚动,包括跨过拖动阈值的移动,与 SScrollBox 的行为一致,因此内容会一直保持在抓住它的指针下方。仅限内容之上:从滚动框自身滚动条上开始的右键拖动属于滚动条,而滚动条只响应左键(参见 UDreamScrollBar::AcceptedMouseButtons),因此它什么也不会滚动。
bConsumePointerInputboolScroll BoxyesGetConsumePointerInput / SetConsumePointerInput此滚动框已处理的指针事件是否被吞掉——即 UMG 的 bConsumePointerInput。关闭则让它传递给滚动框之后绘制的任何内容。
AnalogMouseWheelKeyFKeyScroll BoxyesGetAnalogMouseWheelKey / SetAnalogMouseWheelKey充当此滚动框鼠标滚轮的模拟按键——即 UMG 的 AnalogMouseWheelKey。Invalid(默认值)表示“输入预设已经路由到这里的任何按键”,即右摇杆,因此与所有现有滚动框的行为完全一致。
ScrollWhenFocusChangesEDreamUIScrollWhenFocusChangesScroll BoxyesGetScrollWhenFocusChanges / SetScrollWhenFocusChanges当用户焦点落在其内部时此滚动框的行为——即 UMG 的 ScrollWhenFocusChanges。
NavigationDestinationEDreamUIScrollDestinationScroll BoxyesGetNavigationDestination / SetNavigationDestination通过导航显现的控件最终停留的位置——即 UMG 的 NavigationDestination。IntoView 移动显示它所需的最小距离;另外两个总是以相同方式为其取景。
NavigationScrollPaddingfloatScroll BoxyesGetNavigationScrollPadding / SetNavigationScrollPadding在其周围保持多宽的窗口留白——即 UMG 的 NavigationScrollPadding。
ScrollProgressfloatScroll BoxyesGetScrollProgress / SetScrollProgress沿滚动轴的位置,从 0 到 1。向内编写;是行为输出的镜像,因此 .dui 绑定和设计师都能看到它。
FaceNodeTObjectPtr<UDreamWidget>Scroll Box-read only
ViewportNodeTObjectPtr<UDreamWidget>Scroll Box-read only
ContentNodeTObjectPtr<UDreamWidget>Scroll Box-read only
ScrollBarNodeTObjectPtr<UDreamScrollBar>Scroll Box-read only
ScrollViewTObjectPtr<UUIScrollView>Scroll Box-read only
ContentStackTObjectPtr<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)可调用设置滚轮滚动倍数

事件

事件签名描述
OnScrolledvoid DreamScrollBoxScrolledEvent__DelegateSignature(float Progress)从滚动行为重新广播,因此消费者绑定到控件而非其某个部件。
OnUserScrolledvoid DreamScrollBoxUserScrolledOffsetEvent__DelegateSignature(float CurrentOffset)由 USER(用户)移动——对应 UMG 的 OnUserScrolled,以及其单位,该单位是偏移量而非进度。
OnScrollBarVisibilityChangedvoid DreamScrollBoxBarVisibilityChangedEvent__DelegateSignature(bool bVisible)滚动条出现或消失——对应 UMG 的 OnScrollBarVisibilityChanged。由样式推送触发,那是唯一做决定的地方,且仅当结果实际变化时才触发。
OnFocusUpdatedvoid DreamScrollBoxFocusUpdatedEvent__DelegateSignature(UDreamWidget* FocusedWidget)焦点移到框内的某个内容——对应 UMG 的 OnFocusUpdated。
OnValueChangedBPvoid DreamScrollBoxScrolledEvent__DelegateSignature(float Progress)<-> 约定:双向绑定会针对这个确切的名称合成其反向路径。滚动框的值就是它滚动到的位置,因此它携带一个值并用 OnScrolled 触发它。

与 UMG 的对比

UMG 类中每个面向蓝图的成员,以及它们的去向。adopt:名称相同、含义相同。map:在此处换用其他名称或位于其他类型上。reject:有意缺失,并说明原因。

UMG成员状态此处说明
UScrollBoxScrollAnimationInterpolationSpeedmapWheelScrollAnimationDuration此处的缓动滚动会在固定的 DURATION(持续时间)内平滑移动,而不是以固定速度进行插值,因此调节参数是持续时间。手感相同,参数化方式不同;UDreamLayoutContainerScrollBox 以 UMG 的名称承载基于速度的形式,供布局路径使用。
UScrollBoxbEnableTouchScrollingadoptbEnableTouchScrolling推送到 UUIScrollView::bEnableTouchScrolling;该门控依据事件系统当前的输入设备,因为手指和鼠标都以指针 0 的形式到达。
UScrollBoxbConsumePointerInputadoptbConsumePointerInput一个存储位:UUIScrollView::AllowEventBubbleUp,只是反过来询问。行为上的 Get/SetConsumePointerInput 是它的反向视图。
UScrollBoxAnalogMouseWheelKeyadoptAnalogMouseWheelKey默认为无效 = 输入预设路由到这里的任何内容(右摇杆),也就是当前行为。指定按键会缩小范围;该预设只绑定右摇杆的两个轴,因此任何其他按键都需要项目绑定。
UScrollBoxbIsFocusablemapUDreamWidget::bIsFocusable已经存在于每个控件的基类上;在此控件上再放一个会遮蔽它(UHT 错误),并成为第二个答案。
UScrollBoxWidgetStylemapStyleFDreamScrollBoxStyle,根据项目样式表解析。Get/SetStyle。
UScrollBoxWidgetBarStylemapFDreamScrollBoxStyle::Bar盒子的样式承载了滚动条的完整样式,因此一次编辑就能同时装扮盒子和它的滚动条。
UScrollBoxOrientationmapOrientation名称和含义相同;类型是 EDreamPanelOrientation 而不是 TEnumAsByte,后者是本库自己的双值写法。
UScrollBoxScrollBarVisibilitymapScrollBarVisibilityEDreamScrollBoxScrollbarVisibility(Permanent / AutoHide / Hidden)加上 bShowScrollBar 用于“完全不显示滚动条”,而不是 UMG 的 ESlateVisibility。本库没有 Slate 可见性枚举。AutoHide 跟随内容:每次重新测量(AddContent、RefreshContentExtent、调整大小)都会再次询问,因此当内容开始或停止溢出时,滚动条会出现或消失——连同它的留白一起——就像 SScrollBar 那样。Hidden 从不绘制滚动条,并在有内容可滚动时保留其留白,就像隐藏的 Slate 滚动条保留其槽位一样;盒子仍可通过滚轮、拖动和代码滚动。
UScrollBoxConsumeMouseWheeladoptConsumeMouseWheelEDreamScrollBoxConsumeMouseWheel,同样的三种答案;推送到 UUIScrollView。
UScrollBoxScrollbarThicknessmapFDreamScrollBarStyle::Thickness控件上的一对读取/写入方法(Get/SetScrollbarThickness),而不是第二个字段:样式才是唯一真相。使用 float,因为滚动条在其自身轴向上只有一个厚度;UMG 的 FVector2D 写出的第二个数字在这里没有用处。
UScrollBoxScrollbarPaddingmapFDreamScrollBarStyle::BarPadding新的样式字段,默认 FMargin(0) = 每个滚动条一直绘制的方式。计入留白,因为留白就是视口为滚动条让出的所有空间。
UScrollBoxAlwaysShowScrollbarmapScrollBarVisibilityPermanent 就是始终显示,因此 IsAlwaysShowScrollbar / SetAlwaysShowScrollbar 读写的是那个枚举,而不是它旁边的一个标志。
UScrollBoxAlwaysShowScrollbarTrackadoptbAlwaysShowScrollbarTrack只影响空闲轨道的透明度,与 UMG 中一样(SScrollBar::GetTrackOpacity):启用时空闲轨道以一半的 alpha 绘制,不启用时完全不绘制,而悬停或拖动时无论如何都完整绘制;Permanent 时空闲轨道也以一半绘制。当没有任何内容滚动时,它既不保留滚动条也不保留其留白——只有 ScrollBarVisibility 为 Permanent 才会如此。
UScrollBoxAllowOverscrolladoptbAllowOverscroll推送到 UUIScrollView::bAllowOverscroll,它门控越界阻尼器,而不是将作者的数字归零。
UScrollBoxBackPadScrollingadoptbBackPadScrolling一个完整窗口的前置空间,与 Slate 的消耗相同(不是计划草图中所画的半个窗口)。此处可在运行时写入;UMG 的只能构造时设置。
UScrollBoxFrontPadScrollingadoptbFrontPadScrolling一个完整窗口的后置空间。可在运行时写入,不同于 UMG 的。
UScrollBoxbAnimateWheelScrollingadoptbAnimateWheelScrolling
UScrollBoxNavigationDestinationadoptNavigationDestinationEDreamUIScrollDestination,现在有 BottomOrRight,因此 UMG 的四种答案都存在。
UScrollBoxNavigationScrollPaddingadoptNavigationScrollPadding此处可在运行时写入;UMG 的只能构造时设置。
UScrollBoxScrollWhenFocusChangesadoptScrollWhenFocusChanges默认为 AnimatedScroll,而不是 UMG 的 NoScroll:此处的导航一直会显示其目标,而 NoScroll 会阻止每个现有的手柄驱动列表跟随焦点。
UScrollBoxbAllowRightClickDragScrollingadoptbAllowRightClickDragScrolling在拖动开始时询问一次,因此被拒绝的手势在其整个过程中都保持被拒绝——并且当没有任何内容可滚动时,无论此项如何设置,右键拖动都会被拒绝,就像 SScrollBox 只在其滚动条 IsNeeded 时才接受拖动一样。拖动从按下时开始滚动,包括越过拖动阈值的移动,就像 SScrollBox 那样,因此内容会停留在抓住它的指针下方。从盒子自己的滚动条上开始的右键拖动不会滚动任何内容:滚动条只响应左键(UDreamScrollBar::AcceptedMouseButtons,SScrollBar 的规则),而拖动内容的视图位于滚动条旁边的视口上,因此该手势两者都到达不了——而在 SScrollBox 中,未被应答的按下会向上冒泡,从而拖动内容。
UScrollBoxWheelScrollMultiplieradoptWheelScrollMultiplier缩放 ScrollSensitivity,即一个刻度覆盖的 DISTANCE(距离)。名称和含义与列表控件的相同。
UScrollBoxSetConsumeMouseWheeladoptSetConsumeMouseWheel
UScrollBoxSetOrientationadoptSetOrientation
UScrollBoxSetScrollBarVisibilityadoptSetScrollBarVisibility
UScrollBoxSetScrollbarThicknessadoptSetScrollbarThickness接受 float;写入样式并将 StyleSource 切换为 Inline,这样下一次样式推送就不会丢弃该数字。
UScrollBoxSetScrollbarPaddingadoptSetScrollbarPadding
UScrollBoxSetAlwaysShowScrollbaradoptSetAlwaysShowScrollbar
UScrollBoxSetAllowOverscrolladoptSetAllowOverscroll
UScrollBoxSetAnimateWheelScrollingadoptSetAnimateWheelScrolling
UScrollBoxSetScrollAnimationInterpolationSpeedmapSetWheelScrollAnimationDuration参见属性行:本库的缓动滚动基于持续时间。
UScrollBoxSetWheelScrollMultiplieradoptSetWheelScrollMultiplier
UScrollBoxGetConsumePointerInputadoptGetConsumePointerInput
UScrollBoxSetConsumePointerInputadoptSetConsumePointerInput
UScrollBoxSetScrollWhenFocusChangesadoptSetScrollWhenFocusChanges
UScrollBoxSetNavigationDestinationadoptSetNavigationDestination
UScrollBoxEndInertialScrollingadoptEndInertialScrolling丢弃甩动,并让任何张开的橡皮筋弹回闭合,这不是惯性。
UScrollBoxGetAnalogMouseWheelKeyadoptGetAnalogMouseWheelKey
UScrollBoxSetAnalogMouseWheelKeyadoptSetAnalogMouseWheelKey
UScrollBoxGetIsFocusablemapUDreamWidget::GetIsFocusable在基类上,与该属性一起。
UScrollBoxSetIsFocusablemapUDreamWidget::SetIsFocusable在基类上,与该属性一起。
UScrollBoxOnUserScrolledadoptOnUserScrolled一个偏移量,按 UMG 的上报方式。仅当玩家做出的更改时才触发:此控件自身推送的所有内容都会在推送时刻被标记,而那是两条路径唯一可区分的地方。
UScrollBoxOnScrollBarVisibilityChangedadoptOnScrollBarVisibilityChanged是一个 bool 而不是 ESlateVisibility,本库中没有后者。从样式推送中触发,且仅在发生变化时。
UScrollBoxOnFocusReceivedadoptOnFocusReceived该事件是每个控件都已拥有的 UDreamWidget::OnFocusReceived(UserIndex、PointerId);此框添加的是中继,因为事件系统聚焦的是 FACE 而不是控件。一个按需添加到 FACE 并受基类的 bIsFocusable 门控的 UUISelectable,后者默认关闭——因此没有任何现有滚动框成为导航候选。该 selectable 正是事件系统将焦点交给的东西,也是已经能够区分静止指针与焦点的东西,因此它的状态确实会收到和失去;只有 EDGE 会被通告,因为该状态在重绘时也会被重新应用。
UScrollBoxOnFocusLostadoptOnFocusLostUDreamWidget::OnFocusLost,从 face 中继而来:同一订阅的另一条边,处于同一门控之下。
UScrollBoxOnFocusUpdatedadoptOnFocusUpdated焦点在框内部移动,携带取得焦点的控件。不受 bIsFocusable 门控——无论框是否可聚焦,内容都是可聚焦的。由导航揭示通过 UUIScrollView::NotifyContentFocusMoved 引发:该遍历是唯一一处既知道哪个控件取得了焦点、又知道哪些滚动祖先包含它的地方,而轮询 HasFocusedDescendants 将是为一条边而进行的一次 tick。
UScrollBoxSetScrollOffsetadoptSetScrollOffset
UScrollBoxGetScrollOffsetadoptGetScrollOffset
UScrollBoxGetOverscrollOffsetadoptGetOverscrollOffset有符号:起点之前为负,终点之后为正,在范围内为零,且当过度滚动关闭时也为零。
UScrollBoxGetOverscrollPercentageadoptGetOverscrollPercentage窗口的百分比,按 SScrollBox 的上报方式。
UScrollBoxGetScrollOffsetOfEndadoptGetScrollOffsetOfEnd
UScrollBoxGetViewFractionadoptGetViewFraction
UScrollBoxGetViewOffsetFractionadoptGetViewOffsetFraction行为已经维护的进度;不是第二次除法。
UScrollBoxScrollToStartadoptScrollToStart
UScrollBoxScrollToEndadoptScrollToEnd
UScrollBoxScrollWidgetIntoViewadoptScrollWidgetIntoView全部四个参数,附加目的地和内边距,以便旧的二参数调用保持其含义:Configured 和负内边距均表示“此框所设置的任何内容”。在 UUIScrollView 和 UDreamLayoutContainerScrollBox 上具有相同的签名。
UScrollBoxGetIsScrollingadoptGetIsScrolling

本页目录