类参考
UDreamLayoutContainerBorder
UDreamLayoutContainerBorder
声明于 Public/Core/Components/DreamPanelLayouts.h。
UMG 的 UBorder:单个子项、可设置内边距,由边框本身而非子项槽位决定对齐。
最后这一点是这里唯一无法用带有矩形块视觉的 Overlay 表达的内容,也正是它成为一个类的原因。在本插件的其他所有地方,对齐都属于槽位——“我在被给予的空间里处于什么位置”——而边框将其反转:对齐是容器对其内容放置位置的声明。从 UMG 过来的作者会在边框上设置 HorizontalAlignment,而在此之前该属性无处安放。
背景是所属控件自身的视觉,这也是这里所有其他绘制内容的运作方式。BrushColor 会为其着色,正如 SBorder 用 BorderBackgroundColor 乘以其画刷一样,且不会触及视觉自身的颜色(UDreamVisual::SetColorMultiplier)。这里没有 Background FSlateBrush:DreamGUI 控件的图稿来自其视觉(精灵、矩形块、图像),添加第二个图稿来源会是对渲染路径的分叉,而不是对面板的移植。
SBorder 在其画刷之上添加的内容这里也有:ContentColorAndOpacity 为边框所包含的内容着色,而绝不为背景着色;禁用的边框会按禁用效果的 45% alpha 绘制其背景;背景可以为从右到左的文化进行镜像。
属性
| 名称 | 类型 | 类别 | 在细节面板中 | 可从蓝图访问 | 描述 |
|---|---|---|---|---|---|
Padding | FMargin | Border | 是 | SetPadding | |
HorizontalAlignment | EDreamPanelHorizontalAlignment | Border | 是 | SetHorizontalAlignment | 边框放置其内容的位置。会覆盖内容槽位自身的对齐方式,与 UMG 的行为一致。 |
VerticalAlignment | EDreamPanelVerticalAlignment | Border | 是 | SetVerticalAlignment | |
DesiredSizeScale | FVector2D | Border | 是 | SetDesiredSizeScale | UMG 的 UBorder::DesiredSizeScale:缩放该边框上报的尺寸,而不是它排列的尺寸。 |
BrushColor | FLinearColor | Border | 是 | SetBrushColor | 对背景(即所属控件的视觉)的着色——在线性空间中与视觉自身的颜色相乘,正如 SBorder 用 BorderBackgroundColor 乘以其画刷。白色会让视觉保持原样。 |
ContentColorAndOpacity | FLinearColor | Border | 是 | SetContentColorAndOpacity | 对边框所包含的一切内容着色,而绝不对其自身背景着色——即 UMG 的 ContentColorAndOpacity,SCompoundWidget 会将其混合到子级所继承的内容中。它是所属控件的内容着色(UDreamWidget::SetContentTint),因此会作用于边框下方的每一个视觉,包括 alpha。 |
bShowEffectWhenDisabled | bool | Border | 是 | SetShowEffectWhenDisabled | 当边框处于禁用状态时(UDreamWidget::GetIsEnabledInHierarchy),按 alpha 的 45% 绘制背景:即 SBorder 的禁用绘制效果,默认 Slate 着色器将其实现为 alpha x 0.45。仅限背景——边框所包含的内容会显示其自身的禁用外观。 |
bFlipForRightToLeftFlowDirection | bool | Border | 是 | SetFlipForRightToLeftFlowDirection | 当该边框按从右到左布局时,将背景左右镜像——即 UMG 的 bFlipForRightToLeftFlowDirection,SBorder 围绕画刷中心的 (-1, 1) 渲染变换。内容不会因此被镜像:内容放置的位置由布局负责镜像,而它也确实这样做了。 |
函数
| 函数 | 类型 | 描述 |
|---|---|---|
void SetBrushColor(FLinearColor Value) | 可调用 | 设置画刷颜色 |
void SetContentColorAndOpacity(FLinearColor Value) | 可调用 | 设置内容颜色和不透明度 |
void SetDesiredSizeScale(FVector2D Value) | 可调用 | 设置期望尺寸缩放 |
void SetFlipForRightToLeftFlowDirection(bool Value) | 可调用 | 设置从右到左流向翻转 |
void SetHorizontalAlignment(EDreamPanelHorizontalAlignment Value) | 可调用 | 设置水平对齐 |
void SetPadding(FMargin Value) | 可调用 | 设置内边距 |
void SetShowEffectWhenDisabled(bool Value) | 可调用 | 设置禁用时显示效果 |
void SetVerticalAlignment(EDreamPanelVerticalAlignment Value) | 可调用 | 设置垂直对齐 |