UDreamTileView
UDreamTileView
继承自 UDreamListViewBase。
声明于 Public/Controls/DreamTileView.h。
一个层级结构由代码而非资产定义的磁贴视图:一种行既横向排布又纵向堆叠的列表。
UMG 的 TileView 继承自它的 ListView 并添加了一个条目 WIDTH;这里的关系相同,理由也相同。构成列表的一切——视口、滚动条、滚动列、行模板、对象池、选择、回收阈值——都归 UDreamListViewBase 所有,此处不再重述。磁贴视图所添加的,是一个以不同方式回答的问题:多少行并排存在。
列数是测量出来的,不是作者填写的
UMG 的磁贴视图在宽度允许的范围内尽可能多地横向容纳条目,并在宽度变化时重新排布,这里也是如此:ResolveColumnCount 用视口除以磁贴间距。作者填写的数量会成为第二个必须与宽度保持一致的数字,而第一次调整尺寸就会终结这种一致——这正是重写行放置逻辑所要消除的同一个公式出现在两个地方的问题。
下限始终为一:视口窄于一个磁贴时,每行显示一个磁贴并对其裁剪,这是可见且可恢复的;而零列则意味着除以零和一个空白控件。
磁贴的尺寸是什么
它的高度是 FDreamListStyle::RowHeight——与列表行高来自同一个字段,因为它们是同一种测量——它的宽度是 FDreamTileViewStyle::TileWidth。没有宽高比锁定,也没有“正方形”标志:两个数字已经能表达那些标志所能表达的所有形状,而锁定会让两者之一在面板中变得不可读。
其余内容参见 UDreamListViewBase,扁平情形参见 UDreamListView。
属性
| 名称 | 类型 | 分类 | 在细节面板中 | 来自蓝图 | 描述 |
|---|---|---|---|---|---|
Style | FDreamTileViewStyle | Tile View | 是 | GetStyle / SetStyle | 此实例自身的外观。当 StyleSource 如此指示且项目中确实存在样式表时,项目样式表优先;项目中没有任何样式表时,这就是实际生效的外观。 |
TileAlignment | EDreamTileAlignment | Tile View | 是 | GetTileAlignment / SetTileAlignment | 一行的磁贴如何沿宽度分布——UMG 的 TileAlignment。 |
bWrapHorizontalNavigation | bool | Tile View | 是 | GetWrapHorizontalNavigation / SetWrapHorizontalNavigation | 从一行末端步进时是否落到下一行——UMG 的 bWrapHorizontalNavigation。 |
函数
| 函数 | 种类 | 描述 |
|---|---|---|
int32 GetColumnCount() | 纯函数 | 当前视口内横向能容纳多少个磁贴:布局正在使用的测量结果。 |
float GetEntryHeight() | 纯函数 | 磁贴的高度——UMG 的 EntryHeight,这里即 FDreamListStyle::RowHeight,因为它是与列表行高相同的测量。一个磁贴一种尺寸,由样式持有。 |
float GetEntryWidth() | 纯函数 | 磁贴的宽度——UMG 的 EntryWidth,这里即 FDreamTileViewStyle::TileWidth。 |
int32 GetNavigationTarget(int32 InDisplayIndex, EDreamUINavigationDirection InDirection) | 纯函数 | 从 InDisplayIndex 沿某个方向步进一格后的显示索引,若“超出网格”则为 INDEX_NONE。 |
int32 GetRowLineCount() | 纯函数 | 在当前列数下,数据源会生成多少「行」磁贴。 |
FDreamTileViewStyle GetStyle() | 纯函数 | 按值返回而非按引用:UFUNCTION 的返回值必须是值,而样式是一个小型结构体。 |
EDreamTileAlignment GetTileAlignment() | 纯函数 | 获取磁贴对齐方式 |
bool GetWrapHorizontalNavigation() | 纯函数 | 获取水平导航换行 |
void SetEntryHeight(float InHeight) | 可调用 | 设置条目高度 |
void SetEntryWidth(float InWidth) | 可调用 | 改变横向能容纳的磁贴数量,因此是重新排布而非重新绘制。 |
void SetStyle(FDreamTileViewStyle InStyle) | 可调用 | 替换整体外观并重新推送。磁贴的尺寸属于样式,因此这会重建所有磁贴。 |
void SetTileAlignment(EDreamTileAlignment InAlignment) | 可调用 | 在不改变容纳数量的前提下改变每个磁贴的位置,因此是重新放置而非重新排布。 |
void SetWrapHorizontalNavigation(bool bInWrap) | 可调用 | 设置水平导航换行 |
与 UMG 的对比
UMG 该类中每一个面向蓝图的成员,以及它去了哪里。adopt:名称相同、含义相同。map:在这里以另一个名称出现或位于另一个类型上。reject:有意缺失,并附上理由。
| UMG | 成员 | 状态 | 此处 | 说明 |
|---|---|---|---|---|
UTileView | SetEntryHeight | adopt | SetEntryHeight | 写入 FDreamListStyle::RowHeight 并将 StyleSource 切换为 Inline,这样下一次样式推送不会把该数值丢弃。 |
UTileView | SetEntryWidth | adopt | SetEntryWidth | 写入 FDreamTileViewStyle::TileWidth。不同的宽度意味着不同的列数,因此是重新排布而非重新绘制。 |
UTileView | GetEntryHeight | adopt | GetEntryHeight | 基于已解析的样式,因此使用项目样式表的磁贴视图会以其实际绘制的尺寸作答。 |
UTileView | GetEntryWidth | adopt | GetEntryWidth | 与 GetEntryHeight 一样,基于已解析的样式。 |
UTileView | EntryHeight | map | FDreamListStyle::RowHeight | 与列表行高来自同一个字段,因为它们是同一种测量。一个磁贴一种尺寸,由样式持有——控件上的第二个字段就是把同一个数字写两遍。 |
UTileView | EntryWidth | map | FDreamTileViewStyle::TileWidth | 磁贴相对于一行所添加的唯一东西。没有宽高比锁定,也没有正方形标志:两个数字已经能表达那些东西所能表达的所有形状,而锁定会让两者之一在面板中变得不可读。 |
UTileView | TileAlignment | adopt | TileAlignment | EDreamTileAlignment,UMG 的七种答案。默认是 LeftAligned,而不是 UMG 的 EvenlyDistributed:这是这里每个磁贴视图一贯绘制的方式,一个在升级时自行重新分配间距的网格会是一次没人要求的布局变更。这七种都由同一个函数 ResolveLineLayout 处理,它一并返回该行的起点、磁贴尺寸和间距——它们是同一块剩余空间的三种视图,分开来回答正是两种模式最终对之产生分歧的原因。EvenlySize 按「列」数计算尺寸,以便每一行都一致;Fill 按「本行」的数量计算尺寸,以便较短的末行被拉伸。这是两者之间唯一的区别。 |
UTileView | bWrapHorizontalNavigation | adopt | bWrapHorizontalNavigation | 在 UDreamTileView::GetNavigationTarget 中按索引回答,而非按几何:从一行末端出去就是下一行的第一个磁贴,而它落到的那个磁贴位于控件的「对侧」边缘——正是最近矩形导航器无法完成的那一步。磁贴上的导航按键步进所依据的就是 GetNavigationTarget,因此该开关能传达到玩家。默认关闭,与 UMG 相同:此时从一行末端按键会离开磁贴视图。 |
UTileView | ScrollbarDisabledVisibility | map | ScrollBarVisibility | AutoHide 已经表示「全部容纳时隐藏」,这正是 UMG 的 disabled 可见性所描述的状态。为 disabled 情形再设一个枚举就会是第二个答案。 |
UTileView | bEntrySizeIncludesEntrySpacing | reject | 一个用于切换所填尺寸是磁贴本身还是磁贴加其间隙的开关。在这里它们是两个从不相加的字段:TileWidth 是磁贴,TileSpacing 是它旁边的间隙,因此不存在需要标志来消解的歧义。 |