在上篇中我们讲到拓展我们的ContentBrowser的文件夹右键菜单。看回上篇代码可以发现其实真正起实现拓展(看到效果)的代码就只有一行。
在代码中我们可以看到 MenuBuilder 这个东西是可以为我们创建一个菜单的,今天我们继续来改造它。首先我们先来看看效果。
第一个是弹出的小菜单,这次我们在C++中写好将它开放到蓝图里面,需要生成的菜单名称和按钮点击的逻辑全部在蓝图层面完成;第二个是我们比较熟悉的ContentBrowser文件夹浏览器,今天我们将它提取出来。有时候我们制作一些带界面的插件也需要进行文件夹选择功能这个时候就要用到这个文件夹浏览器了。
废话结束
首先我们在项目里面创建C++的蓝图函数库 这里名称可以随意(我这边的命名 ToolFunctionLibrary )
接下来就贴上代码
.h
// Fill out your copyright notice in the Description page of Project Settings.
#pragma once
#include "CoreMinimal.h"
#include "Kismet/BlueprintFunctionLibrary.h"
#include "SlateApplication.h"
#include "ToolFunctionLibrary.generated.h"
DECLARE_DYNAMIC_DELEGATE_OneParam(FUIActionClick,FString,UILabel);
DECLARE_DYNAMIC_DELEGATE_OneParam(FOnSelectChange,const FString&,Path);
/**
*
*/
UCLASS()
class UToolFunctionLibrary : public UBlueprintFunctionLibrary
{
GENERATED_BODY()
public:
/*
* 创建一个PickerBrowser(和ContentBrowser 中的文件夹浏览器一样)
*
* @param InParentWidget 父类控件表示这个弹出的菜单是属于那个UI控件里面的
* @param OnSelectChange 这个是一个带一个参数的动态代理(动态代理支持在蓝图中绑定事件)这个代理将会在我们选择文件夹时进行回调
*/
UFUNCTION(BlueprintCallable)
static void CreatePickerBrowser(UUserWidget* InParentWidget, FOnSelectChange OnSelectChange);
/*
* 创建一个弹出的菜单(可应用到右键弹出快截菜单中)
* @param InParentWidget 父类控件表示这个弹出的菜单是属于那个UI控件里面的
* @param LabelArr 这个是你要创建的菜单的名称的数组例如我想创建多个菜单就在这个数组里面添加多个菜单的名称就好了
* @param ActionDel 这个是一个带一个参数的动态代理(动态代理支持在蓝图中绑定事件) 这个代理将会在菜单被点击时进行回调
*/
UFUNCTION(BlueprintCallable)
static void OpenTextureMenu(UWidget* InParentWidget, const TArray<FString>& LabelArr, FUIActionClick ActionDel);
private:
static TSharedPtr<IMenu> PickerMenu;
};
.cpp
#include "ToolFunctionLibrary.h"
#include "ContentBrowser/Public/ContentBrowserModule.h"
#include "ModuleManager.h"
#include "ContentBrowser/Public/IContentBrowserSingleton.h"
//这里要初始化一下静态变量
TSharedPtr<IMenu> UToolFunctionLibrary::PickerMenu = NULL;
void UToolFunctionLibrary::CreatePickerBrowser(UUserWidget* InParentWidget, FOnSelectChange OnSelectChange)
{
//国际惯例既然是内容浏览器的东西肯定要拿到 ContentBrowser 这个模块
FContentBrowserModule& ContentBrowserModule = FModuleManager::LoadModuleChecked<FContentBrowserModule>("ContentBrowser");
//创建一份路径选择的一个结构体 这个结构体里面包含了一些路径选择器的一些参数以及回调内容
FPathPickerConfig PathPickerConfig;
//这个路径选择器的每个文件夹是否拥有右键菜单
PathPickerConfig.bAllowContextMenu = false;
//路径选择变更时的回调
PathPickerConfig.OnPathSelected = FOnPathSelected::CreateLambda([OnSelectChange](const FString& Path){
//判断是否有效
if (PickerMenu.IsValid())
{
//关闭控件
PickerMenu->Dismiss();
//共享指针重置 引用计数归0
PickerMenu.Reset();
}
//回调到蓝图的绑定事件
OnSelectChange.ExecuteIfBound(Path);
});
//第一个参数点击之后是否关闭控件 在这里是不生效的因为我们点击的不是MenuBuilder创建出来的Menu
//我们在这里只是利用了MenuBuilder当一个容器实际点击的还是 ContentBrowserModule.Get().CreatePathPicker(PathPickerConfig) 里创建的控件
FMenuBuilder MenuBuilder(true, NULL);
//在这个菜单构建器中添加 Slate 控件
//创建一个Sobx 对应UMG的Size Box
MenuBuilder.AddWidget(SNew(SBox)
.WidthOverride(300.0f)
.HeightOverride(300.0f)
[
//创建一个路径选择器放在Size box 下面
ContentBrowserModule.Get().CreatePathPicker(PathPickerConfig)
], FText());
//将这个创建好的控件显示到我们的UI上
PickerMenu = FSlateApplication::Get().PushMenu(InParentWidget->TakeWidget(), //父控件
FWidgetPath(),
MenuBuilder.MakeWidget(), //要显示的控件
FSlateApplication::Get().GetCursorPos(), // 创建在什么位置这里我们直接获取当前鼠标的位置就好了
FPopupTransitionEffect(FPopupTransitionEffect::ContextMenu)
);
}
void UToolFunctionLibrary::OpenTextureMenu(UWidget* InParentWidget,const TArray<FString>& LabelArr, FUIActionClick ActionDel)
{
//第一个参数点击后是否关闭这里能实际生效
FMenuBuilder MenuBuilder(true, NULL);
for(int i=0;i<LabelArr.Num();i++)
{
//这里特别说明要创建一个共享指针,不然出了这个函数作用域 fstring 就不生效了等我们回调时使用到这个Fstring 就会奔溃。
TSharedPtr<FString> TempString = MakeShareable(new FString(LabelArr[i]));
MenuBuilder.AddMenuEntry(FText::FromString(*TempString.Get()), FText(), FSlateIcon(),
FUIAction(FExecuteAction::CreateLambda([TempString,ActionDel]() { //UI点击事件
ActionDel.ExecuteIfBound(*TempString.Get());
})));
}
//这里跟上面的路径选择器创建一样
FSlateApplication::Get().PushMenu(InParentWidget->TakeWidget(),
FWidgetPath(),
MenuBuilder.MakeWidget(),
FSlateApplication::Get().GetCursorPos(),
FPopupTransitionEffect(FPopupTransitionEffect::ContextMenu)
);
}
回到蓝图我们写调用方法
第一个功能
上图演示中第一个功能其实是一张Image的右键菜单我们可以在这个Image 控件的Mouse button down 方法里面这样调用并在事件图标里面写一个叫UIMenuAction带传入Fstring的事件 在这个事件里面我们可以处理按钮点击的逻辑
第二个功能
第二个功能的逻辑很简单 回调回来的Fstring就是点击是所选的路径
最后
本文旨在记录学习过程和分享,如有错误请帮我指出。