前言

在UE4中存在大量的菜单栏和工具栏。如下面所示

本质上上面都是菜单栏和工具栏。

菜单(Menu)的扩展点(ExtendPoints)

在Edit->Editor Preferences->Miscellaneous->Display UI ExtendsionPoints勾选,开始显示引擎编辑器的UI扩展点功能

这些绿色的扩展点主要是用于菜单按钮和工具按钮的排序的,添加一个绿色的扩展点统管N个菜单按钮,如果你可以自定义自己的UI扩展点,并将自己的扩展点下的菜单按钮安插在某个扩展点之后。也就是UI扩展点是用于布局菜单栏和工具栏的顺序的。如果开发菜单和工具栏,最好在编辑器打开 “Display UI ExtendsionPoints” 这个辅助功能。

TCommands,FUICommandInfo,FUICommandList

本质上来说我们的菜单按钮和工具按钮其实也是一个按钮,点击菜单按钮执行的事件和“SButton的OnClick”可以看作是一样的。(PS: 看源码可以知道菜单按钮也是封装的SButton) 不过UE4为了别的目的,菜单按钮执行的事件绑定用了Commands命令绑定的方式。

FUICommandInfo

命令信息,用于绑定菜单执行的事件(Delegate)

TCommands

命令集合,用于声明各种FUICommandInfo和注册FUICommandInfo

class FTestMenuCommands : public TCommands<FTestMenuCommands>
{
public:FTestMenuCommands(): TCommands<FTestMenuCommands>(TEXT("TestMenu"), NSLOCTEXT("Contexts", "TestMenu", "TestMenu Plugin"), NAME_None, FTestMenuStyle::GetStyleSetName()){}// TCommands<> interfacevirtual void RegisterCommands() override;public:TSharedPtr< FUICommandInfo > PluginAction;TSharedPtr< FUICommandInfo > TestAction;
};

在RegisterCommands函数中利用 UI_COMMAND进行命令的注册

void FTestMenuCommands::RegisterCommands()
{UI_COMMAND(PluginAction, "TestMenu", "Execute TestMenu action", EUserInterfaceActionType::Button, FInputGesture());UI_COMMAND(TestAction, "aaa", "Execute aaa", EUserInterfaceActionType::Button, FInputGesture());
}

其中的FInputGesture可以于键盘Key绑定,比如直接按住“Delete”键触发菜单按钮事件。

FInputGesture(EKeys::Delete)

在每个模块开始得手动注册命令

 FTestMenuCommands::Register();

FUICommandList

FUICommandList是命令队列,每个FUICommandInfo绑定委托都得通过FUICommandList的MapAction接口来

 //初始化FUICommandListTSharedPtr<class FUICommandList> PluginCommands;PluginCommands = MakeShareable(new FUICommandList);//绑定动作PluginCommands->MapAction(FTestMenuCommands::Get().PluginAction,FExecuteAction::CreateRaw(this, &FTestMenuModule::PluginButtonClicked),FCanExecuteAction());void FTestMenuModule::TestClicked()
{FMessageDialog::Open(EAppMsgType::Ok, FText::FromString("1111111111111112222222"));
}

这里的FUICommandList的存在很多个重载的MapAction,不过都得由传入执行事件的委托变量FExecuteAction

/** Defines FExecuteAction delegate interface */
DECLARE_DELEGATE(FExecuteAction);
void FUICommandList::MapAction( const TSharedPtr< const FUICommandInfo > InUICommandInfo, FExecuteAction ExecuteAction, FCanExecuteAction CanExecuteAction, EUIActionRepeatMode RepeatMode )

像上面的话我们就为一个命令(FUICommandInfo)绑定了执行事件

FExtend扩展

扩展引擎编辑器的系统菜单栏,主要添加的控件由三种:FMenuBuilder, FMenuBarBuilder,FToolBarBuilder

并且都是FExtend来扩展,FExtend提供了AddMenuExtension来扩展Menu,AddMenuBarExtension扩展MenuBar, AddToolBarExtension扩展ToolBar.  FExtend最后都在FLevelEditorModule中管理

FLevelEditorModule& LevelEditorModule = FModuleManager::LoadModuleChecked<FLevelEditorModule>("LevelEditor");

FMenuBuilder

FMenuBarBuilder主要用于菜单的扩展

TSharedPtr<FExtender> MenuExtender = MakeShareable(new FExtender());MenuExtender->AddMenuExtension("WindowLayout", EExtensionHook::After, PluginCommands, FMenuExtensionDelegate::CreateRaw(this, &FTestMenuModule::AddMenuExtension));LevelEditorModule.GetMenuExtensibilityManager()->AddExtender(MenuExtender);void FTestMenuModule::AddMenuExtension(FMenuBuilder& Builder)
{Builder.AddMenuEntry(FTestMenuCommands::Get().PluginAction);Builder.AddMenuEntry(FTestMenuCommands::Get().PluginAction);Builder.AddSubMenu(FText::FromString("MyTestLevel"), FText::FromString("MyTestLevel"), FNewMenuDelegate::CreateRaw(this, &FTestMenuModule::AddMenuSubMenu), false);
}void FTestMenuModule::AddMenuSubMenu(FMenuBuilder& Builder)
{Builder.AddMenuEntry(FTestMenuCommands::Get().TestAction);Builder.AddMenuSeparator();Builder.AddMenuEntry(FTestMenuCommands::Get().TestAction);Builder.AddSearchWidget();Builder.AddWrapperSubMenu(FText::FromString("Test"), FText::FromString("MyTest"), FOnGetContent::CreateRaw(this, &FTestMenuModule::GetWapperSubMenuContent), FSlateIcon());}

(1)

AddMenuExtension( FName ExtensionHook, EExtensionHook::Position HookPosition, const TSharedPtr< FUICommandList >& CommandList, const FMenuExtensionDelegate& MenuExtensionDelegate )

ExtensionHook就是上面图中的绿色显示的UI扩展点,用于定位我们添加的菜单控件的位置是相对于哪个扩展点,相对位置指定:

​
/** Where in relation to an extension hook should you apply your extension */
namespace EExtensionHook
{enum Position{/** Inserts the extension before the element or section. */Before,/** Inserts the extension after the element or section. */After,/** Sections only. Inserts the extension at the beginning of the section. */First,};
}​

(2)这里BeginSectionEndSection是自定义UI扩展点的范围.

(3)在FMenuExtensionDelegate中可以继续扩展新的菜单,可以看作是嵌套。FMenuBuilder提供了AddMenuEntry(菜单项)和AddSubMenu(添加子菜单)可以继续嵌套式扩展菜单栏。

效果:

FMenuBarBuilder

FMenuBarBuilder主要用于主菜单的扩展

在这主菜单添加新的菜单,

TSharedPtr<FExtender> MenuBarExtend = MakeShareable(new FExtender());MenuBarExtend->AddMenuBarExtension("Help", EExtensionHook::After, PluginCommands, FMenuBarExtensionDelegate::CreateRaw(this, &FTestMenuModule::AdddMenuBarExtend));LevelEditorModule.GetMenuExtensibilityManager()->AddExtender(MenuBarExtend);void FTestMenuModule::AdddMenuBarExtend(FMenuBarBuilder& Builder)
{Builder.AddPullDownMenu(FText::FromString("Test"), FText::FromString("MyTest"), FNewMenuDelegate::CreateRaw(this, &FTestMenuModule::AddPullDownMenu));
}
AddMenuBarExtension( FName ExtensionHook, EExtensionHook::Position HookPosition, const TSharedPtr< FUICommandList >& CommandList, const FMenuBarExtensionDelegate& MenuBarExtensionDelegate 

后面添加的菜单可以继续通过绑定的委托FMenuBarExtensionDelegate扩展, 如果你希望继续扩展这个菜单栏,就继续在委托里继续利用FMenuBarBuilder的AdddMenuBarExtend等接口往下嵌套

void FTestMenuModule::AdddMenuBarExtend(FMenuBarBuilder& Builder)
{Builder.AddPullDownMenu(FText::FromString("Test"), FText::FromString("MyTest"), FNewMenuDelegate::CreateRaw(this, &FTestMenuModule::AddPullDownMenu));
}void FTestMenuModule::AddPullDownMenu(FMenuBuilder& Builder)
{Builder.BeginSection(FName("TestEditor"));Builder.AddMenuEntry(FTestMenuCommands::Get().TestAction);Builder.EndSection();
}

效果:

FToolBarBuilder

FToolBarBuilder扩展工具栏

和前面差不多

 TSharedPtr<FExtender> ToolbarExtender = MakeShareable(new FExtender);ToolbarExtender->AddToolBarExtension("Settings", EExtensionHook::After, PluginCommands, FToolBarExtensionDelegate::CreateRaw(this, &FTestMenuModule::AddToolbarExtension));LevelEditorModule.GetToolBarExtensibilityManager()->AddExtender(ToolbarExtender);void FTestMenuModule::AddToolbarExtension(FToolBarBuilder& Builder)
{Builder.AddToolBarButton(FTestMenuCommands::Get().PluginAction);Builder.AddToolBarButton(FTestMenuCommands::Get().PluginAction);Builder.AddComboButton(FUIAction(), FOnGetContent::CreateRaw(this, &FTestMenuModule::GetComboConent), FText::FromString("aaaadd"));
}

(1)AddToolBarButton添加工具按钮

(2)AddComboButton添加下拉连续按钮,可以通过FOnGetContent委托任意填充下拉按钮内容,只要是Sidget就行。

不过经常是填充FMenuBuilder建立的内容,像UE4的地形编辑器的各种ToolMode就是这样构造。


TSharedRef<SWidget> FTestMenuModule::GetComboConent()
{FMenuBuilder MenuBuilder(true, PluginCommands);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);return MenuBuilder.MakeWidget();
}
DECLARE_DELEGATE_RetVal(/** return a widget */TSharedRef<SWidget>,FOnGetContent
)AddComboButton( const FUIAction& InAction, const FOnGetContent& InMenuContentGenerator, const TAttribute<FText>& InLabelOverride, const TAttribute<FText>& InToolTipOverride, const TAttribute<FSlateIcon>& InIconOverride, bool bInSimpleComboBox, FName InTutorialHighlightName )

效果:

FMenuBuilder, FMenuBarBuilder,FToolBarBuilder公共接口

其实FMenuBuilder, FMenuBarBuilder,FToolBarBuilder都是继承于FMultiBoxBuilder,部分公用接口挺有用的

MakeWidget转为SCompoundWidget

我们可以单独的建立菜单栏和工具栏,用MakeWidget转为Swidget对象,然后我们的菜单栏和工具栏就可以在Slate中的进行嵌套了,在UE4编辑器开发中经常会见到这样的开发技巧,如

    FMenuBuilder MenuBuilder(true, PluginCommands);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);MenuBuilder.AddMenuEntry(FTestMenuCommands::Get().TestAction);SNew(SHorizontalBox)+ SHorizontalBox::Slot()[MenuBuilder.MakeWidget()]

Tab窗口

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

参考资料

[1]. UE4地形编辑器源码:SLandscapeEditor.h, LandscapeEditorDetails.cpp,SLandscapeEditor.cpp

[2].https://docs.unrealengine.com/zh-CN/Programming/Slate/Overview/index.html

(UE4 4.21 ) UE4给编辑器添加菜单栏(Menu),工具栏(TooBar),Tab窗口相关推荐

  1. QT ui添加菜单栏和工具栏

    ui添加菜单栏和工具栏,我本来是纯代码写的,但是现在感觉真的很麻烦,不如ui直接添加,省去了不少麻烦 菜单栏 先新建一个设计师界面类,界面模板选择mianwindow 双击这里,输入菜单名字,回车,就 ...

  2. Qt添加菜单栏和工具栏

    一.需求与目的 一般常规的PC软件都会有主窗口,主窗口中都会有菜单栏和工具栏,例如我们正在使用的Qt creator: 二.详细说明 首先需要先创建mainWindow设计师类,基类直接选择默认的Ma ...

  3. 添加菜单栏和工具栏,状态栏,铆接核心部件

    之前说的都是基于widget类的,现在要学QMainWindow类的项目,创建时选这个类. 一开始和widget没有区别,因为你没有添加任何东西. 添加菜单栏就是QMenubar,注意要把这个放到窗口 ...

  4. Qt 添加菜单栏和工具栏

    一.需求与目的 一般常规的PC软件都会有主窗口,主窗口中都会有菜单栏和工具栏,例如我们正在使用的Qt creator: 所以,工具栏和菜单栏的制作方法也是必须掌握的. 二.详细说明 首先需要先创建ma ...

  5. Toolbar添加菜单栏Menu

    1.res中menu包下新建菜单布局 2.Activity中 1)关联菜单布局 public boolean onCreateOptionsMenu(Menu menu) {//导入菜单布局getMe ...

  6. MFC——基于MFC对话框程序中添加菜单栏 (CMenu)解决方案

    开发环境 Visual C++ 6.0 MFC 解决方案 一.将Menu加入Resource视图中 在WorkSpace中的Resource视图下,在任意一个文件夹图标上,右击选择Insert(插入) ...

  7. 在WordPress后台文章编辑器添加首行缩进2字符的按钮

    在WordPress后台文章编辑器添加首行缩进2字符的按钮  2016-12-10 14:51    网页设计   标签:wordpress 模板 代码   2358    发表评论 受到z-blog ...

  8. QT添加菜单栏-工具栏-中心区域-状态栏-dock 示范

    QT添加菜单栏-工具栏-中心区域-状态栏-dock 示范 QT添加菜单栏-工具栏-中心区域-状态栏-dock示范.rar-QT文档类资源-CSDN下载QT添加菜单栏-工具栏-中心区域-状态栏-dock ...

  9. 文本编辑器中菜单栏删除功能的实现

    文章目录 1 文本编辑器中菜单栏删除功能的实现 1 文本编辑器中菜单栏删除功能的实现 菜单栏中删除功能的实现: 定义事件对象KeyPress. 定义事件对象KeyRelease. 发送事件KeyPre ...

最新文章

  1. Q:文件或目录的权限是什么意思?
  2. python入门必备指南-致Python初学者 Anaconda入门使用指南完整版
  3. react: nextJs koa project basic structure
  4. CentOS7——vi编辑保存
  5. Inherits、CodeFile、CodeBehind
  6. 新Astaroth***病毒可利用杀毒软件窃取数据
  7. android webview richeditor,GitHub - IllegalCreed/react-native-webview-richeditor
  8. win10自带sftp服务器_用于Windows系统的免费SFTP服务器-Free SFTP Servers及各款软件功能对比...
  9. 渗透入门——术语概述
  10. 常见图片格式总结--网页设计必备
  11. 超小白教程之快速排序
  12. PAT甲级 1087 条条大路通罗马
  13. B站最专业的DC漫威UP主,深度挖掘漫威故事内容。
  14. python生成一个四位数字的随机数
  15. 学生HTML游戏网页作业作品——HTML+CSS+JavaScript魔域私服游戏HTML(1个页面)
  16. 【SSL 协议介绍】
  17. 富田刹车马达特点和用途
  18. 邮政储蓄银行 软件开发 2020暑期实习 面试回忆
  19. JS图片灯箱(lightBox)效果基本原理和demo
  20. BUAA(2021春)机试检测异常(简)(期末考试题)——简单排序

热门文章

  1. 电子印章均为智能印章模式
  2. 网络规划中的IP地址分配
  3. 遍历想要属性里面的所有方法
  4. C#多线程编程笔记(1.2)-检测线程状态State
  5. UI设计目前岗位饱和吗,工资薪酬怎么样
  6. Jenkins自动部署前端项目
  7. c语言 队列---->链表实现
  8. 分手只为更好!Keras正式从TensorFlow分离
  9. 腾讯电子签如何免费领取25份合同礼包
  10. Java和C语言的区别在哪里?