- Inside of the Chapter_10Editor folder, create a new header file, CookbookCommands.h, and insert the following class declaration:<\/li><\/ol>\n\n\n\n
#pragma once
#include \"Commands.h\"
#include \"EditorStyleSet.h\"
class FCookbookCommands : public TCommands<FCookbookCommands>
{
public:
FCookbookCommands()
: TCommands<FCookbookCommands>(
FName(TEXT(\"UE4_Cookbook\")),
FText::FromString(\"Cookbook Commands\"),
NAME_None,
FEditorStyle::GetStyleSetName())
{
};
virtual void RegisterCommands() override;
TSharedPtr<FUICommandInfo> MyButton;
TSharedPtr<FUICommandInfo> MyMenuButton;
};<\/pre>\n\n\n\n- Implement the new class by placing the following in the .cpp file:<\/li><\/ol>\n\n\n\n
#include \"CookbookCommands.h\"
#include \"Chapter_10Editor.h\"
#include \"Commands.h\"
void FCookbookCommands::RegisterCommands()
{
#define LOCTEXT_NAMESPACE \"\"
UI_COMMAND(MyButton, \"Cookbook\", \"Demo Cookbook Toolbar Command\", EUserInterfaceActionType::Button, FInputGesture());
UI_COMMAND(MyMenuButton, \"Cookbook\", \"Demo Cookbook Toolbar Command\", EUserInterfaceActionType::Button, FInputGesture());
#undef LOCTEXT_NAMESPACE
}
<\/pre>\n\n\n\n- Next, we will need to update our module class (Chapter_10Editor.h) to the following:<\/li><\/ol>\n\n\n\n
#pragma once
#include \"Engine.h\"
#include \"Modules\/ModuleInterface.h\"
#include \"Modules\/ModuleManager.h\"
#include \"UnrealEd.h\"
#include \"CookbookCommands.h\"<\/strong>
#include \"Editor\/MainFrame\/Public\/Interfaces\/IMainFrameModule.h\"<\/strong>
class FChapter_10EditorModule: public IModuleInterface
{
virtual void StartupModule() override;<\/strong>
virtual void ShutdownModule() override;<\/strong>
TSharedPtr<FExtender> ToolbarExtender;<\/strong>
TSharedPtr<const FExtensionBase> Extension;<\/strong>
void MyButton_Clicked()<\/strong>
{<\/strong>
TSharedRef<SWindow> CookbookWindow = SNew(SWindow)<\/strong>
.Title(FText::FromString(TEXT(\"Cookbook Window\")))<\/strong>
.ClientSize(FVector2D(800, 400))<\/strong>
.SupportsMaximize(false)<\/strong>
.SupportsMinimize(false);<\/strong>
IMainFrameModule& MainFrameModule =<\/strong>
FModuleManager::LoadModuleChecked<IMainFrameModule><\/strong>
(TEXT(\"MainFrame\"));<\/strong>
if (MainFrameModule.GetParentWindow().IsValid())<\/strong>
{<\/strong>
FSlateApplication::Get().AddWindowAsNativeChild<\/strong>
(CookbookWindow, MainFrameModule.GetParentWindow()<\/strong>
.ToSharedRef());<\/strong>
}<\/strong>
else<\/strong>
{<\/strong>
FSlateApplication::Get().AddWindow(CookbookWindow);<\/strong>
}<\/strong>
};<\/strong>
void AddToolbarExtension(FToolBarBuilder &builder)<\/strong>
{<\/strong>
FSlateIcon IconBrush =<\/strong>
FSlateIcon(FEditorStyle::GetStyleSetName(),<\/strong>
\"LevelEditor.ViewOptions\",<\/strong>
\"LevelEditor.ViewOptions.Small\"); builder.AddToolBarButton(FCookbookCommands::Get()<\/strong>
.MyButton, NAME_None, FText::FromString(\"My Button\"),<\/strong>
FText::FromString(\"Click me to display a message\"),<\/strong>
IconBrush, NAME_None);<\/strong>
};<\/strong>
}; <\/pre>\n\n\n\nBe sure to #include the header file for your command class as well.<\/p>\n\n\n\n
- We now need to implement StartupModule and ShutdownModule:<\/li><\/ol>\n\n\n\n
#include \"Chapter_10Editor.h\"
#include \"Modules\/ModuleManager.h\"
#include \"Modules\/ModuleInterface.h\"
#include \"LevelEditor.h\" <\/strong>
#include \"SlateBasics.h\" <\/strong>
#include \"MultiBoxExtender.h\" <\/strong>
#include \"CookbookCommands.h\" <\/strong>
IMPLEMENT_GAME_MODULE(FChapter_10EditorModule, Chapter_10Editor)
void FChapter_10EditorModule::StartupModule()<\/strong>
{<\/strong>
FCookbookCommands::Register();<\/strong>
TSharedPtr<FUICommandList> CommandList = MakeShareable(new FUICommandList());<\/strong>
CommandList->MapAction(FCookbookCommands::Get().MyButton, FExecuteAction::CreateRaw(this, &FChapter_10EditorModule::MyButton_Clicked), FCanExecuteAction());<\/strong>
ToolbarExtender = MakeShareable(new FExtender());<\/strong>
FLevelEditorModule& LevelEditorModule = FModuleManager::LoadModuleChecked<FLevelEditorModule>( \"LevelEditor\" );<\/strong>
Extension = ToolbarExtender->AddToolBarExtension(\"Compile\", EExtensionHook::Before, CommandList, FToolBarExtensionDelegate::CreateRaw(this, &FChapter_10EditorModule::AddToolbarExtension)); <\/strong>
LevelEditorModule.GetToolBarExtensibilityManager()->AddExtender(ToolbarExtender);<\/strong>
}<\/strong>
void FChapter_10EditorModule::ShutdownModule()<\/strong>
{<\/strong>
ToolbarExtender->RemoveExtension(Extension.ToSharedRef());<\/strong>
Extension.Reset();<\/strong>
ToolbarExtender.Reset();<\/strong>
}<\/strong><\/pre>\n\n\n\n- Regenerate your project piles if needed, compile your project from Visual Studio and start the editor.<\/li>
- Verify that there’s a new button on the toolbar in the main level editor, which can be clicked on to open a new window:<\/li><\/ol>\n\n\n\n
![\"\"\/](\"http:\/\/blog.coolcoding.cn\/wp-content\/uploads\/2021\/01\/6f9e599c-aee8-4438-a084-5350a219f1ea.png\")
<\/figure>\n\n\n\nHow it works…<\/h1>\n\n\n\n
Unreal’s editor UI is based on the concept of commands. Commands are a design pattern that allows looser coupling between the UI and the actions that it needs to perform.<\/p>\n\n\n\n
To create a class that contains a set of commands, it is necessary to inherit from TCommands.<\/p>\n\n\n\n
TCommands is a template class that leverages the Curiously Recurring Template Pattern<\/strong> (CRTP<\/strong>). The CRTP is used commonly throughout Slate UI code as a means of creating compile-time polymorphism.<\/p>\n\n\n\n
In the initializer list for FCookbookCommands constructor, we invoke the parent class constructor, passing in a number of parameters:<\/p>\n\n\n\n
- The first parameter is the name of the command set, and is a simple FName.<\/li>
- The second parameter is a tooltip\/human readable string, and, as such, uses FText so that it can support localization if necessary.<\/li>
- If there’s a parent group of commands, the third parameter contains the name of the group. Otherwise, it contains NAME_None.<\/li>
- The final parameter for the constructor is the Slate Style set that contains any command icons that the command set will be using.<\/li><\/ul>\n\n\n\n
The RegisterCommands() function allows TCommands-derived classes to create any command objects that they require. The resulting FUICommandInfo instances that are returned from that function are stored inside the Commands class as members so that UI elements or functions can be bound to the commands.<\/p>\n\n\n\n
This is why we have the member variable TSharedPtr<FUICommandInfo> MyButton.<\/p>\n\n\n\n
In the implementation for the class, we simply need to create our commands in RegisterCommands.<\/p>\n\n\n\n
The UI_COMMAND macro that was used to create an instance of FUICommandInfo expects a localization namespace to be defined, even if it is just an empty default namespace. As a result, we need to enclose our UI_COMMAND calls with #defines to set a valid value for LOCTEXT_NAMESPACE, even if we don’t intend to use localization.<\/p>\n\n\n\n
The actual UI_COMMAND macro takes a number of parameters:<\/p>\n\n\n\n
- The first parameter is the variable to store the FUICommandInfo in<\/li>
- The second parameter is a human-readable name for the command<\/li>
- The third parameter is a description for the command<\/li>
- The fourth parameter is EUserInterfaceActionType<\/li><\/ul>\n\n\n\n
This enumeration essentially specifies what sort of button is being created. It supports Button, ToggleButton, RadioButton, and Check as valid types.<\/p>\n\n\n\n
Buttons are simple generic buttons. A toggle button stores on and off states. The radio button is similar to a toggle, but is grouped with other radio buttons, and only one can be enabled at a time. Lastly, the checkbox displays a read-only checkbox that’s adjacent to the button.<\/p>\n\n\n\n
The last parameter for UI_COMMAND is the input chord, or the combination of keys that are required to activate the command.<\/p>\n\n\n\n
This parameter is primarily useful for defining key combinations for hotkeys linked to the command in question, rather than buttons. As a result, we use an empty InputGesture.<\/p>\n\n\n\n
So, we now have a set of commands, but we haven’t told the engine we want to add the set to the commands that show on the toolbar. We also haven’t set up what actually happens when the button is clicked. To do this, we need to perform some initialization when our module begins, so we place some code into the StartupModule\/ShutdownModule functions.<\/p>\n\n\n\n
Inside StartupModule, we call the static Register function on the commands class that we defined earlier.<\/p>\n\n\n\n
We then create a shared pointer to a list of commands using the MakeShareable function.<\/p>\n\n\n\n
In the command list, we use MapAction to create a mapping, or association, between the UICommandInfo object, which we set as a member of the FCookbookCommands, and the actual function we want to execute when the command is invoked.<\/p>\n\n\n\n
You’ll note that we don’t explicitly set anything regarding what could be used to invoke the command here.<\/p>\n\n\n\n
To perform this mapping, we call the MapAction function. The first parameter to MapAction is a FUICommandInfo object, which we can retrieve from FCookbookCommands by using its static Get() method to retrieve the instance.<\/p>\n\n\n\n
FCookbookCommands is implemented as a singleton \u2013 a class with a single instance that exists throughout the application. You’ll see the pattern in most places \u2013 there’s a static Get() method available in the engine.<\/p>\n\n\n\n
The second parameter of the MapAction function is a delegate bound to the function to be invoked when the command is executed.<\/p>\n\n\n\n
Because Chapter_10EditorModule is a raw C++ class rather than a UObject, and we want to invoke a member function rather than a static function, we use CreateRaw to create a new delegate that’s bound to a raw C++ member function.<\/p>\n\n\n\n
CreateRaw expects a pointer to the object instance, and a function reference to the function to invoke on that pointer.<\/p>\n\n\n\n
The third parameter for MapAction is a delegate to call to test if the action can be executed. Because we want the command to be executable all the time, we can use a simple predefined delegate that always returns true.<\/p>\n\n\n\n
With an association created between our command and the action it should call, we now need to actually tell the extension system that we want to add new commands to the toolbar.<\/p>\n\n\n\n
We can do this via the FExtender class, which can be used to extend menus, context menus, or toolbars.<\/p>\n\n\n\n
We initially create an instance of FExtender as a shared pointer so that our extensions are uninitialized when the module is shut down.<\/p>\n\n\n\n
We then call AddToolBarExtension on our new extender, storing the results in a shared pointer so that we can remove it on module uninitialization.<\/p>\n\n\n\n
First argument of AddToolBarExtension is the name of the extension point where we want to add our extension.<\/p>\n\n\n\n
To find where we want to place our extension, we first need to turn on the display of extension points within the editor UI.<\/p>\n\n\n\n
To do so, open Editor Preferences in the Edit menu within the editor:<\/p>\n\n\n\n
![\"\"\/](\"http:\/\/blog.coolcoding.cn\/wp-content\/uploads\/2021\/01\/733efb6c-4df7-4663-b51c-2629dabb48c2.png\")
<\/figure>\n\n\n\nOpen General | Miscellaneous and select Display UIExtension Points:<\/p>\n\n\n\n
![\"\"\/](\"http:\/\/blog.coolcoding.cn\/wp-content\/uploads\/2021\/01\/a7875429-2beb-4350-8952-b13d6b5f419d.png\")
<\/figure>\n\n\n\nRestart the editor, and you should see green text overlaid on the Editor UI, as shown in the following screenshot:<\/p>\n\n\n\n
![\"\"\/](\"https:\/\/learning.oreilly.com\/library\/view\/unreal-engine-4x\/9781789809503\/assets\/9cd351fc-a334-42c3-8155-24fa0772578c.png\")
<\/figure>\n\n\n\nGreen text overlaying the Editor UI<\/p>\n\n\n\n
The green text indicates UIExtensionPoint, and the text’s value is the string we should provide to the AddToolBarExtension function.<\/p>\n\n\n\n
We’re going to add our extension to the Compile extension point in this recipe, but of course, you could use any other extension point you wish.<\/p>\n\n\n\n
It’s important to note that adding a toolbar extension to a menu extension point will fail silently, and vice versa.<\/p>\n\n\n\n
The second parameter to AddToolBarExtension is a location anchor relative to the extension point that’s specified. We’ve selected FExtensionHook::Before, so our icon will be displayed before the compile point.<\/p>\n\n\n\n
The next parameter is our command list that contains mapped actions.<\/p>\n\n\n\n
Finally, the last parameter is a delegate that is responsible for actually adding UI controls to the toolbar at the extension point and the anchor that we specified earlier.<\/p>\n\n\n\n
The delegate is bound to a function that has the form void (*func) (FToolBarBuilder and builder). In this instance, it is a function called AddToolbarExtension, which is defined in our module class.<\/p>\n\n\n\n
When the function is invoked, calling commands on the builder that adds UI elements will apply those elements to the location in the UI we specified.<\/p>\n\n\n\n
Lastly, we need to load the level editor module within this function so that we can add our extender to the main toolbar within the level editor.<\/p>\n\n\n\n
As usual, we can use ModuleManager to load a module and return a reference to it.<\/p>\n\n\n\n
With that reference in hand, we can get the Toolbar Extensibility Manager for the module, and tell it to add our Extender.<\/p>\n\n\n\n
While this may seem cumbersome at first, the intention is to allow you to apply the same toolbar extension to multiple toolbars in different modules, if you would like to create a consistent UI layout between different editor windows.<\/p>\n\n\n\n
The counterpart to initializing our extension, of course, is removing it when our module is unloaded. To do that, we remove our extension from the extender, then null the shared pointers for both Extender and extension, thus reclaiming their memory allocation.<\/p>\n\n\n\n
The AddToolBarExtension function within the editor module is the one that is responsible for actually adding UI elements to the toolbar that can invoke our commands.<\/p>\n\n\n\n
It does this by calling functions on the FToolBarBuilder instance that’s passed in as a function parameter.<\/p>\n\n\n\n
First, we retrieve an appropriate icon for our new toolbar button using the FSlateIcon constructor. Then, with the icon loaded, we invoke AddToolBarButton on the builder instance.<\/p>\n\n\n\n
AddToolbarButton has a number of parameters. The first parameter is the command to bind to \u2013 you’ll notice it’s the same MyButton member that we accessed earlier when binding the action to the command. The second parameter is an override for the extension hook we specified earlier, but we don’t want to override that, so we can use NAME_None. The third parameter is a label override for the new button that we create. Parameter four is a tooltip for the new button. The second to last parameter is the button’s icon, and the last parameter is a name that’s used to refer to this button element for highlighting support if you wish to use the in-editor tutorial framework.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
If you have created a custom tool or window for display […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[27,1],"tags":[26],"_links":{"self":[{"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/posts\/3082"}],"collection":[{"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3082"}],"version-history":[{"count":1,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/posts\/3082\/revisions"}],"predecessor-version":[{"id":3094,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=\/wp\/v2\/posts\/3082\/revisions\/3094"}],"wp:attachment":[{"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3082"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3082"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.coolcoding.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3082"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- We now need to implement StartupModule and ShutdownModule:<\/li><\/ol>\n\n\n\n
- Next, we will need to update our module class (Chapter_10Editor.h) to the following:<\/li><\/ol>\n\n\n\n
- Implement the new class by placing the following in the .cpp file:<\/li><\/ol>\n\n\n\n