类参考
FDreamUIStateFaces
FDreamUIStateFaces
声明于 Public/Controls/DreamControlStyles.h。
同一张脸的五种画法——Slate 的 FButtonStyle 形态,而这正是此处的控件样式无法表达的东西。
控件脸面是一个仅带一层皮肤的程序化矩形,五种状态只能靠颜色区分:如果一个项目的普通按钮和按下按钮是两幅不同的图画,就必须派生控件。这就是此处要填补的空白,而且无需第二个状态机——可选状态已经决定了控件处于五种状态中的哪一种,而这里只是决定该选择绘制什么(参见 UDreamUIControl::UseStateFaces)。
每个字段都是可选的,这正是它不改变任何已有内容的原因。刷子中不含图像的某个状态会回退到 Normal 的,而 Normal 也不含图像时会回退到控件自身的那一个刷子——因此,一个在这里什么都不说的样式,绘制结果与之前完全一致,精确到像素。其他三组同样如此:前景着色由一个默认关闭的开关控制,按下内边距由另一个开关控制,而三个声音均为空。
共享而非按控件设置,因为一个项目的按钮、复选框、下拉脸面和列表行是同一次决定。它是这些样式中每一个的一个字段,而不是一个基结构体:USTRUCT 层级无法在覆盖位合并中存活,该合并会读取一个结构体的属性,并将勾选的属性写入同类型的另一个结构体。
属性
| 名称 | 类型 | 类别 | 在细节面板中 | 来自蓝图 | 描述 |
|---|---|---|---|---|---|
Normal | FDreamUIFaceBrush | 状态脸面 | 是 | 读 / 写 | 静止时的皮肤。为空表示控件自身的刷子,这也是每个样式默认提供的内容。 |
Hovered | FDreamUIFaceBrush | 状态脸面 | 是 | 读 / 写 | 指针停留在其上。为空时回退到 Normal。 |
Pressed | FDreamUIFaceBrush | 状态脸面 | 是 | 读 / 写 | |
Disabled | FDreamUIFaceBrush | 状态脸面 | 是 | 读 / 写 | |
Focused | FDreamUIFaceBrush | 状态脸面 | 是 | 读 / 写 | 持有键盘或游戏手柄焦点,这与悬停是不同的情形——焦点在指针离开后仍然保持,而在手柄上根本没有指针。 |
bTintForeground | bool | 状态脸面 | 是 | 读 / 写 | 下面五种颜色是否被应用。 |
NormalForeground | FColor | 状态脸面 | 是 | 读 / 写 | 控件的 前景 部分——它自己的标签或字形,绝不是宿主的内容——在每个状态下的着色。Slate 的 ForegroundColor,按 FButtonStyle 的方式逐状态设置。 |
HoveredForeground | FColor | 状态脸面 | 是 | 读 / 写 | |
PressedForeground | FColor | 状态脸面 | 是 | 读 / 写 | |
DisabledForeground | FColor | 状态脸面 | 是 | 读 / 写 | |
FocusedForeground | FColor | 状态脸面 | 是 | 读 / 写 | |
bUsePressedPadding | bool | 状态脸面 | 是 | 读 / 写 | 是否使用 PressedPadding。关闭时,按下的控件保持其静止时的内边距。 |
PressedPadding | FMargin | 状态脸面 | 是 | 读 / 写 | 按下时 围绕内容的内边距——Slate 的 PressedPadding,也是按钮看起来被按下的经典方式:顶部偏重的边距将标签向下推一个像素。静止时的数值是控件自己的 ContentPadding,而不是在这里再做一份副本;参见 UDreamButton。 |
HoveredSound | TObjectPtr<USoundBase> | 状态脸面 | 是 | 读 / 写 | 控件发出声音的三个时刻,作为一项 样式 决定:一次点击听起来应该像此 UI 中的其他点击,这与颜色所持的论点相同。 |
PressedSound | TObjectPtr<USoundBase> | 状态脸面 | 是 | 读 / 写 | |
ClickedSound | TObjectPtr<USoundBase> | 状态脸面 | 是 | 读 / 写 |