(UE4 4.21 ) UE4给编辑器添加菜单栏(Menu),工具栏(TooBar),Tab窗口
前言
在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)这里BeginSection和EndSection是自定义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窗口相关推荐
- QT ui添加菜单栏和工具栏
ui添加菜单栏和工具栏,我本来是纯代码写的,但是现在感觉真的很麻烦,不如ui直接添加,省去了不少麻烦 菜单栏 先新建一个设计师界面类,界面模板选择mianwindow 双击这里,输入菜单名字,回车,就 ...
- Qt添加菜单栏和工具栏
一.需求与目的 一般常规的PC软件都会有主窗口,主窗口中都会有菜单栏和工具栏,例如我们正在使用的Qt creator: 二.详细说明 首先需要先创建mainWindow设计师类,基类直接选择默认的Ma ...
- 添加菜单栏和工具栏,状态栏,铆接核心部件
之前说的都是基于widget类的,现在要学QMainWindow类的项目,创建时选这个类. 一开始和widget没有区别,因为你没有添加任何东西. 添加菜单栏就是QMenubar,注意要把这个放到窗口 ...
- Qt 添加菜单栏和工具栏
一.需求与目的 一般常规的PC软件都会有主窗口,主窗口中都会有菜单栏和工具栏,例如我们正在使用的Qt creator: 所以,工具栏和菜单栏的制作方法也是必须掌握的. 二.详细说明 首先需要先创建ma ...
- Toolbar添加菜单栏Menu
1.res中menu包下新建菜单布局 2.Activity中 1)关联菜单布局 public boolean onCreateOptionsMenu(Menu menu) {//导入菜单布局getMe ...
- MFC——基于MFC对话框程序中添加菜单栏 (CMenu)解决方案
开发环境 Visual C++ 6.0 MFC 解决方案 一.将Menu加入Resource视图中 在WorkSpace中的Resource视图下,在任意一个文件夹图标上,右击选择Insert(插入) ...
- 在WordPress后台文章编辑器添加首行缩进2字符的按钮
在WordPress后台文章编辑器添加首行缩进2字符的按钮 2016-12-10 14:51 网页设计 标签:wordpress 模板 代码 2358 发表评论 受到z-blog ...
- QT添加菜单栏-工具栏-中心区域-状态栏-dock 示范
QT添加菜单栏-工具栏-中心区域-状态栏-dock 示范 QT添加菜单栏-工具栏-中心区域-状态栏-dock示范.rar-QT文档类资源-CSDN下载QT添加菜单栏-工具栏-中心区域-状态栏-dock ...
- 文本编辑器中菜单栏删除功能的实现
文章目录 1 文本编辑器中菜单栏删除功能的实现 1 文本编辑器中菜单栏删除功能的实现 菜单栏中删除功能的实现: 定义事件对象KeyPress. 定义事件对象KeyRelease. 发送事件KeyPre ...
最新文章
- Q:文件或目录的权限是什么意思?
- python入门必备指南-致Python初学者 Anaconda入门使用指南完整版
- react: nextJs koa project basic structure
- CentOS7——vi编辑保存
- Inherits、CodeFile、CodeBehind
- 新Astaroth***病毒可利用杀毒软件窃取数据
- android webview richeditor,GitHub - IllegalCreed/react-native-webview-richeditor
- win10自带sftp服务器_用于Windows系统的免费SFTP服务器-Free SFTP Servers及各款软件功能对比...
- 渗透入门——术语概述
- 常见图片格式总结--网页设计必备
- 超小白教程之快速排序
- PAT甲级 1087 条条大路通罗马
- B站最专业的DC漫威UP主,深度挖掘漫威故事内容。
- python生成一个四位数字的随机数
- 学生HTML游戏网页作业作品——HTML+CSS+JavaScript魔域私服游戏HTML(1个页面)
- 【SSL 协议介绍】
- 富田刹车马达特点和用途
- 邮政储蓄银行 软件开发 2020暑期实习 面试回忆
- JS图片灯箱(lightBox)效果基本原理和demo
- BUAA(2021春)机试检测异常(简)(期末考试题)——简单排序