类参考
UDreamLayoutContainerMenuAnchor
UDreamLayoutContainerMenuAnchor
声明于 Public/Core/Components/DreamPanelLayouts.h。
UMG 的 UMenuAnchor 的布局侧实现。
第一个子级是锚点——按钮、组合框的正面——并像 Border 的内容一样被填充。可选的第二个子级是菜单:它不会参与此面板的测量尺寸(一个会长出自己按钮的菜单将无法使用),并由 Placement 放置在锚点的矩形旁,然后在设置 bFitInWindow 时被限制在根控件内。
当没有作为第二个子级编写的菜单时,每次菜单打开时都会构建一个——通过 OnGetMenuContent,否则从 MenuClass 构建——并在关闭时销毁,就像 UMG 构建和释放其菜单内容一样。
菜单绘制的位置由 bUseApplicationMenuStack 决定。关闭时,它就地绘制:被锚点的祖先裁剪,并与其兄弟一起排序,正如每个已保存的锚点一直以来的绘制方式。开启时,菜单在其打开期间会进入其玩家的弹出层(UDreamUIPopupLayer::Push)——位于一切之上,通过在其外部按下、Back 或 Tab、跟随锚点来关闭——并由此面板自身的 Placement 和 bFitInWindow 放置在那里,使用它在此处的槽位(内边距、微调),因此它会落在其就地绘制时会落到的位置。
Properties
| Name | Type | Category | In the details panel | From Blueprint | Description |
|---|---|---|---|---|---|
Placement | EDreamMenuPlacement | MenuAnchor | yes | SetPlacement | |
bFitInWindow | bool | MenuAnchor | yes | SetFitInWindow | 将放置的菜单保持在根控件的矩形内,移动它而不是让它悬出。 |
bIsOpen | bool | MenuAnchor | yes | SetIsOpen | |
bUseApplicationMenuStack | bool | MenuAnchor | yes | SetUseApplicationMenuStack | 在其玩家的弹出层上打开菜单,而不是就地打开——即 UMG 的 UseApplicationMenuStack。菜单在打开期间会被提升到玩家的屏幕根上,因此没有祖先会裁剪它;在其外部按下、Back 或其锚点消失都会关闭它(bIsOpen 也随之关闭);它跟随锚点,由 Placement 和 bFitInWindow 放置。默认关闭,而 UMG 的默认开启,因此在此功能存在之前保存的锚点会继续就地绘制。 |
MenuClass | TSubclassOf<UDreamUserWidget> | MenuAnchor | yes | SetMenuClass | 一个用户控件,每次菜单打开时创建,关闭时销毁——即 UMG 的 MenuClass。当没有作为第二个子级编写的菜单且 OnGetMenuContent 未返回任何内容时使用。 |
OnGetMenuContent | FDreamPanelMenuAnchorGetContent | MenuAnchor | - | read / write | 每次菜单打开时都会被询问以获取菜单,优先于 MenuClass——即 UMG 的 OnGetUserMenuContentEvent。它返回的内容会作为菜单放置在此锚点下,并从此归锚点所有:菜单关闭时销毁,就像 UMG 释放所给内容一样。每次请提供新的控件。当有作为第二个子级编写的菜单时忽略。 |
Functions
| Function | Kind | Description |
|---|---|---|
UDreamWidget* GetAnchorContent() | pure | 第一个子级:菜单所锚定的对象。面板为空时返回 null。 |
UDreamWidget* GetMenuContent() | pure | 菜单:第二个子级,编写的或构建的——或者,当它被提升到弹出层上时,是提升后的控件,此时它在此处不是任何控件的子级。当此锚点没有菜单时返回 null。 |
bool IsOpen() | pure | 是否打开 |
void SetFitInWindow(bool Value) | callable | 设置适合窗口 |
void SetIsOpen(bool Value) | callable | 显示或隐藏菜单。关闭时,它会折叠,因此不消耗布局也不参与命中测试。打开时,当没有编写菜单时会构建菜单,并在 bUseApplicationMenuStack 下将其推入弹出层。 |
void SetMenuClass(TSubclassOf<UDreamUserWidget> Value) | callable | 先关闭由旧类构建的菜单。 |
void SetPlacement(EDreamMenuPlacement Value) | callable | 设置放置方式 |
void SetUseApplicationMenuStack(bool Value) | callable | 立即生效:已打开的菜单会关闭并以另一种方式再次打开。 |
void ToggleOpen() | callable | 切换打开 |