DreamGUI
类参考

UDreamLayoutContainerMenuAnchor

UDreamLayoutContainerMenuAnchor

继承自 UDreamPanelLayoutBase。

声明于 Public/Core/Components/DreamPanelLayouts.h。

UMG 的 UMenuAnchor 的布局侧实现。

第一个子级是锚点——按钮、组合框的正面——并像 Border 的内容一样被填充。可选的第二个子级是菜单:它不会参与此面板的测量尺寸(一个会长出自己按钮的菜单将无法使用),并由 Placement 放置在锚点的矩形旁,然后在设置 bFitInWindow 时被限制在根控件内。

当没有作为第二个子级编写的菜单时,每次菜单打开时都会构建一个——通过 OnGetMenuContent,否则从 MenuClass 构建——并在关闭时销毁,就像 UMG 构建和释放其菜单内容一样。

菜单绘制的位置由 bUseApplicationMenuStack 决定。关闭时,它就地绘制:被锚点的祖先裁剪,并与其兄弟一起排序,正如每个已保存的锚点一直以来的绘制方式。开启时,菜单在其打开期间会进入其玩家的弹出层(UDreamUIPopupLayer::Push)——位于一切之上,通过在其外部按下、Back 或 Tab、跟随锚点来关闭——并由此面板自身的 Placement 和 bFitInWindow 放置在那里,使用它在此处的槽位(内边距、微调),因此它会落在其就地绘制时会落到的位置。

Properties

NameTypeCategoryIn the details panelFrom BlueprintDescription
PlacementEDreamMenuPlacementMenuAnchoryesSetPlacement
bFitInWindowboolMenuAnchoryesSetFitInWindow将放置的菜单保持在根控件的矩形内,移动它而不是让它悬出。
bIsOpenboolMenuAnchoryesSetIsOpen
bUseApplicationMenuStackboolMenuAnchoryesSetUseApplicationMenuStack在其玩家的弹出层上打开菜单,而不是就地打开——即 UMG 的 UseApplicationMenuStack。菜单在打开期间会被提升到玩家的屏幕根上,因此没有祖先会裁剪它;在其外部按下、Back 或其锚点消失都会关闭它(bIsOpen 也随之关闭);它跟随锚点,由 Placement 和 bFitInWindow 放置。默认关闭,而 UMG 的默认开启,因此在此功能存在之前保存的锚点会继续就地绘制。
MenuClassTSubclassOf<UDreamUserWidget>MenuAnchoryesSetMenuClass一个用户控件,每次菜单打开时创建,关闭时销毁——即 UMG 的 MenuClass。当没有作为第二个子级编写的菜单且 OnGetMenuContent 未返回任何内容时使用。
OnGetMenuContentFDreamPanelMenuAnchorGetContentMenuAnchor-read / write每次菜单打开时都会被询问以获取菜单,优先于 MenuClass——即 UMG 的 OnGetUserMenuContentEvent。它返回的内容会作为菜单放置在此锚点下,并从此归锚点所有:菜单关闭时销毁,就像 UMG 释放所给内容一样。每次请提供新的控件。当有作为第二个子级编写的菜单时忽略。

Functions

FunctionKindDescription
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切换打开

本页目录