DreamGUI
类参考

FDreamUIStateFaces

FDreamUIStateFaces

声明于 Public/Controls/DreamControlStyles.h。

同一张脸的五种画法——Slate 的 FButtonStyle 形态,而这正是此处的控件样式无法表达的东西。

控件脸面是一个仅带一层皮肤的程序化矩形,五种状态只能靠颜色区分:如果一个项目的普通按钮和按下按钮是两幅不同的图画,就必须派生控件。这就是此处要填补的空白,而且无需第二个状态机——可选状态已经决定了控件处于五种状态中的哪一种,而这里只是决定该选择绘制什么(参见 UDreamUIControl::UseStateFaces)。

每个字段都是可选的,这正是它不改变任何已有内容的原因。刷子中不含图像的某个状态会回退到 Normal 的,而 Normal 也不含图像时会回退到控件自身的那一个刷子——因此,一个在这里什么都不说的样式,绘制结果与之前完全一致,精确到像素。其他三组同样如此:前景着色由一个默认关闭的开关控制,按下内边距由另一个开关控制,而三个声音均为空。

共享而非按控件设置,因为一个项目的按钮、复选框、下拉脸面和列表行是同一次决定。它是这些样式中每一个的一个字段,而不是一个基结构体:USTRUCT 层级无法在覆盖位合并中存活,该合并会读取一个结构体的属性,并将勾选的属性写入同类型的另一个结构体。

属性

名称类型类别在细节面板中来自蓝图描述
NormalFDreamUIFaceBrush状态脸面是读 / 写静止时的皮肤。为空表示控件自身的刷子,这也是每个样式默认提供的内容。
HoveredFDreamUIFaceBrush状态脸面是读 / 写指针停留在其上。为空时回退到 Normal。
PressedFDreamUIFaceBrush状态脸面是读 / 写
DisabledFDreamUIFaceBrush状态脸面是读 / 写
FocusedFDreamUIFaceBrush状态脸面是读 / 写持有键盘或游戏手柄焦点,这与悬停是不同的情形——焦点在指针离开后仍然保持,而在手柄上根本没有指针。
bTintForegroundbool状态脸面是读 / 写下面五种颜色是否被应用。
NormalForegroundFColor状态脸面是读 / 写控件的 前景 部分——它自己的标签或字形,绝不是宿主的内容——在每个状态下的着色。Slate 的 ForegroundColor,按 FButtonStyle 的方式逐状态设置。
HoveredForegroundFColor状态脸面是读 / 写
PressedForegroundFColor状态脸面是读 / 写
DisabledForegroundFColor状态脸面是读 / 写
FocusedForegroundFColor状态脸面是读 / 写
bUsePressedPaddingbool状态脸面是读 / 写是否使用 PressedPadding。关闭时,按下的控件保持其静止时的内边距。
PressedPaddingFMargin状态脸面是读 / 写按下时 围绕内容的内边距——Slate 的 PressedPadding,也是按钮看起来被按下的经典方式:顶部偏重的边距将标签向下推一个像素。静止时的数值是控件自己的 ContentPadding,而不是在这里再做一份副本;参见 UDreamButton。
HoveredSoundTObjectPtr<USoundBase>状态脸面是读 / 写控件发出声音的三个时刻,作为一项 样式 决定:一次点击听起来应该像此 UI 中的其他点击,这与颜色所持的论点相同。
PressedSoundTObjectPtr<USoundBase>状态脸面是读 / 写
ClickedSoundTObjectPtr<USoundBase>状态脸面是读 / 写

本页目录