devbox
IT小白
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

UE5插件创建控件蓝图_ue5 createwidget

作者：IT小白 | 2024-02-18 09:51:31

赞

踩

ue5 createwidget

一、创建插件

        选择 编辑器工具栏按钮，插件名为 CreateWBP。

二、添加依赖

        打开 CreateWBP.Build.cs 添加依赖。

UMG

UMGEditor

BlueprintGraph

三、插件代码

        创建 CreateWBPMain.h 和 CreateWBPMain.cpp。

CreateWBPMain.h 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4.  
  5.  
  6. class CreateWBPMain {
  7. public:
  8. 	// 主函数
  9. 	static int Main();
  10.  
  11. 	// 创建用户控件蓝图
  12. 	static UWidgetBlueprint* CreateWidgetBlueprint(FString&, FString&, EObjectFlags = RF_NoFlags);
  13.  
  14. 	// 编译蓝图
  15. 	static void CompileBlueprint(UBlueprint*);
  16.  
  17. 	// 保存蓝图
  18. 	static void SavePackage(UPackage*);
  19. };

CreateWBPMain.cpp 文件

  1. #include "CreateWBPMain.h"
  2. #include "WidgetBlueprintFactory.h"
  3. #include "AssetRegistry/AssetRegistryModule.h"
  4. #include "Blueprint/WidgetTree.h"
  5. #include "Kismet2/KismetEditorUtilities.h"
  6. #include "Kismet2/CompilerResultsLog.h"
  7. #include "BlueprintEditorSettings.h"
  8. #include "FileHelpers.h"
  9.  
  10.  
  11. /* 主函数 */
  12. int CreateWBPMain::Main() {
  13. 	// 随机用户控件蓝图名称。
  14. 	FString Guid = FGuid::NewGuid().ToString();
  15. 	FString WBPName = FString::Printf(TEXT("WBP_Test_%s"), *Guid);
  16. 	FString DirPath = "/Game/";
  17. 	FString WBPDirPath = DirPath + "WBP/";
  18. 	FString WBPPackage = WBPDirPath + WBPName;
  19. 	UE_LOG(LogTemp, Log, TEXT("CreateWBP 路径为： %s"), *WBPPackage);
  20.  
  21. 	// 创建用户控件蓝图
  22. 	UWidgetBlueprint* Widget = CreateWBPMain::CreateWidgetBlueprint(WBPPackage, WBPName);
  23. 	// 编译用户控件蓝图
  24. 	CreateWBPMain::CompileBlueprint(Widget);
  25. 	// 保存用户控件蓝图
  26. 	CreateWBPMain::SavePackage(Widget->GetPackage());
  27.  
  28. 	return 0;
  29. }
  30.  
  31.  
  32. /**
  33. * 创建用户控件蓝图
  34. *	@param {WBPPackage} 蓝图路径
  35. *	@param {WBPName} 蓝图名称
  36. *	@param {ObjectFlags} 对象本身的标志
  37. *	@return 用户控件蓝图指针
  38. */
  39. UWidgetBlueprint* CreateWBPMain::CreateWidgetBlueprint(FString& WBPPackage, FString& WBPName, EObjectFlags ObjectFlags) {
  40. 	UWidgetBlueprint* WidgetBlueprint = nullptr;
  41.  
  42. 	// 检查蓝图是否存在
  43. 	FString WBPPath = WBPPackage + TEXT(".") + WBPName;
  44. 	WidgetBlueprint = Cast<UWidgetBlueprint>(StaticLoadObject(UWidgetBlueprint::StaticClass(), nullptr, *WBPPath));
  45. 	if (WidgetBlueprint) {
  46. 		UE_LOG(LogTemp, Warning, TEXT("控件蓝图已存在，路径：%s"), *WBPPath);
  47. 		// 清空组件
  48. 		if (WidgetBlueprint->WidgetTree->RootWidget) {
  49. 			WidgetBlueprint->WidgetTree->RemoveWidget(WidgetBlueprint->WidgetTree->RootWidget);
  50. 			WidgetBlueprint->Modify();
  51. 		}
  52. 	}
  53. 	else {
  54. 		// 创建用户控件蓝图
  55. 		UWidgetBlueprintFactory* WidgetFactory = NewObject<UWidgetBlueprintFactory>();
  56. 		WidgetFactory->AddToRoot();
  57. 		UPackage* WidgetPackage = CreatePackage(*WBPPackage);
  58. 		WidgetBlueprint = Cast<UWidgetBlueprint>(WidgetFactory->FactoryCreateNew(UWidgetBlueprint::StaticClass(), WidgetPackage, FName(*WBPName), ObjectFlags, nullptr, nullptr));
  59. 		WidgetFactory->RemoveFromRoot();
  60. 		FAssetRegistryModule::AssetCreated(WidgetBlueprint);
  61. 		WidgetBlueprint->AddToRoot();
  62. 	}
  63. 	return WidgetBlueprint;
  64. }
  65.  
  66.  
  67. /**
  68. * 编译用户控件蓝图
  69. *	@param {Blueprint} 用户控件蓝图指针
  70. */
  71. void CreateWBPMain::CompileBlueprint(UBlueprint* Blueprint) {
  72. 	FCompilerResultsLog LogResults;
  73. 	FString BlueprintPathName = Blueprint->GetPathName();
  74. 	UE_LOG(LogTemp, Log, TEXT("开始编译蓝图：%s"), *BlueprintPathName);
  75. 	LogResults.SetSourcePath(BlueprintPathName);
  76. 	LogResults.BeginEvent(*FString::Printf(TEXT("开始编译蓝图：%s"), *BlueprintPathName));
  77. 	LogResults.bLogDetailedResults = GetDefault<UBlueprintEditorSettings>()->bShowDetailedCompileResults;
  78. 	LogResults.EventDisplayThresholdMs = GetDefault<UBlueprintEditorSettings>()->CompileEventDisplayThresholdMs;
  79. 	FKismetEditorUtilities::CompileBlueprint(Blueprint, EBlueprintCompileOptions::None, &LogResults);
  80. }
  81.  
  82.  
  83. /**
  84. * 保存用户控件蓝图
  85. *	@param {SaveObject} 用户控件蓝图指针
  86. */
  87. void CreateWBPMain::SavePackage(UPackage* Package) {
  88. 	FString PackagePathName = Package->GetPathName();
  89. 	UE_LOG(LogTemp, Log, TEXT("开始保存蓝图：%s"), *PackagePathName);
  90. 	TArray<UPackage*> SavePackageArray;
  91. 	SavePackageArray.Add(Package);
  92. 	FEditorFileUtils::PromptForCheckoutAndSave(SavePackageArray, false, false);
  93. }

        *如果 CreateWBPMain.h 提示无法打开源文件"WidgetBlueprint.h"。

                 1、项目 -> DemoWBP属性

                2、配置属性 -> VC++目录 -> 包含目录 -> 编辑

                 3、新行 -> C:\UnrealEngine\UE_5.0\Engine\Source\Editor\UMGEditor\Public

相对路径是\Engine\Source\Editor\UMGEditor\Public，这里 C:\UnrealEngine\UE_5.0 需要替换成UE引擎的路径。

        在 CreateWBP.cpp 中导入刚创建的 CreateWBPMain.h。

        在 CreateWBP.cpp 的 PluginButtonClicked() 方法中调用创建好的主函数。

 四、编译插件

        生成 -> 生成解决方案 

        *记得关掉UE引擎。 

五、生成用户控件蓝图

六、添加组件

WidgetCommon.hpp 文件

  1. #pragma once
  2.  
  3. #include "Engine/Font.h"
  4. #include "Sound/SoundWave.h"
  5. #include "WidgetBlueprint.h"
  6.  
  7.  
  8. class WidgetCommon {
  9. public:
  10. 	/**
  11. 	* 动态加载对象
  12. 	*	@param {Path}		路径
  13. 	*/
  14. 	template<typename T>
  15. 	static T* NewObject(const FString& Path) {
  16. 		// T* Object = Cast<T>(StaticLoadObject(T::StaticClass(), nullptr, *Path));
  17. 		T* Object = LoadObject<T>(nullptr, *Path);
  18. 		if (Object) {
  19. 			return Object;
  20. 		}
  21. 		return nullptr;
  22. 	}
  23.  
  24. 	/**
  25. 	* 创建笔刷
  26. 	*	@param {ResourceObject}								图像
  27. 	*	@param {ImageSize}									图像大小
  28. 	*	@param {TintColor}									着色
  29. 	*	@param {DrawAs}										绘制为
  30. 	*		ESlateBrushDrawType::Type::NoDrawType				无
  31. 	*		ESlateBrushDrawType::Type::Box						盒体
  32. 	*		ESlateBrushDrawType::Type::Border					边界
  33. 	*		ESlateBrushDrawType::Type::Image					图像
  34. 	*		ESlateBrushDrawType::Type::RoundedBox				圆形盒体
  35. 	*	@param {Margin}										边缘（左、上、右、下）（只用于：盒体、边界）
  36. 	*	@param {Tiling}										平铺（只用于：图像）
  37. 	*		ESlateBrushTileType::Type::NoTile					无瓦片
  38. 	*		ESlateBrushTileType::Type::Horizontal				水平
  39. 	*		ESlateBrushTileType::Type::Vertical					垂直
  40. 	*		ESlateBrushTileType::Type::Both						两者
  41. 	*	@param {OutlineRadius}								轮廓设置 - 圆角半径
  42. 	*	@param {OutlineColor}								轮廓设置 - 轮廓
  43. 	*	@param {OutlineWidth}								轮廓设置 - 宽度
  44. 	*	@param {OutlineRoundingType}						轮廓设置 - 舍入类型
  45. 	*		ESlateBrushRoundingType::Type::FixedRadius			固定半径
  46. 	*		ESlateBrushRoundingType::Type::HalfHeightRadius		半高半径
  47. 	*	@param {OutlineUseBrushTransparency}				轮廓设置 - 使用笔刷透明度
  48. 	*/
  49. 	static FSlateBrush CreateBrush(UObject* ResourceObject, FVector2D ImageSize, FSlateColor TintColor, ESlateBrushDrawType::Type DrawAs, FMargin Margin, ESlateBrushTileType::Type Tiling, FVector4 OutlineRadius, const FSlateColor& OutlineColor, float OutlineWidth, ESlateBrushRoundingType::Type OutlineRoundingType, bool OutlineUseBrushTransparency) {
  50. 		FSlateBrushOutlineSettings SlateBrushOutlineSettings(OutlineRadius, OutlineColor, OutlineWidth);
  51. 		SlateBrushOutlineSettings.RoundingType = OutlineRoundingType;
  52. 		SlateBrushOutlineSettings.bUseBrushTransparency = OutlineUseBrushTransparency;
  53. 		FSlateBrush SlateBrush;
  54. 		SlateBrush.SetResourceObject(ResourceObject);
  55. 		SlateBrush.SetImageSize(ImageSize);
  56. 		SlateBrush.TintColor = TintColor;
  57. 		SlateBrush.Margin = Margin;
  58. 		SlateBrush.Tiling = Tiling;
  59. 		SlateBrush.OutlineSettings = SlateBrushOutlineSettings;
  60. 		return SlateBrush;
  61. 	}
  62.  
  63. 	/**
  64. 	* 创建字体
  65. 	*	@param {FontObject}								字体族系
  66. 	*	@param {TypefaceFontName}						字形
  67. 	*	@param {Size}									尺寸
  68. 	*	@param {LetterSpacing}							字间距
  69. 	*	@param {FontMaterial}							字体材质
  70. 	*	@param {OutlineSize}							轮廓设置 - 轮廓大小
  71. 	*	@param {OutlineSeparateFillAlpha}				轮廓设置 - 单独填充透明度
  72. 	*	@param {OutlineApplyOutlineToDropShadows}		轮廓设置 - 对投影应用轮廓
  73. 	*	@param {OutlineMaterial}						轮廓设置 - 轮廓材质
  74. 	*	@param {OutlineColor}							轮廓设置 - 轮廓颜色
  75. 	*/
  76. 	static FSlateFontInfo CreateFont(const UFont* FontObject, FName TypefaceFontName, uint16 Size, int32 LetterSpacing, UMaterialInterface* FontMaterial, int32 OutlineSize, bool OutlineSeparateFillAlpha, bool OutlineApplyOutlineToDropShadows, UMaterialInterface* OutlineMaterial, FLinearColor OutlineColor) {
  77. 		FFontOutlineSettings FontOutlineSettings(OutlineSize, OutlineColor);
  78. 		FontOutlineSettings.bSeparateFillAlpha = OutlineSeparateFillAlpha;
  79. 		FontOutlineSettings.bApplyOutlineToDropShadows = OutlineApplyOutlineToDropShadows;
  80. 		FontOutlineSettings.OutlineMaterial = OutlineMaterial;
  81. 		FSlateFontInfo SlateFontInfo(FontObject, Size, TypefaceFontName, FontOutlineSettings);
  82. 		SlateFontInfo.LetterSpacing = LetterSpacing;
  83. 		SlateFontInfo.FontMaterial = FontMaterial;
  84. 		return SlateFontInfo;
  85. 	}
  86.  
  87. 	/**
  88. 	* 创建音效
  89. 	*	@param {SoundPath}		音效路径
  90. 	*/
  91. 	static FSlateSound CreateSound(const FString& SoundPath) {
  92. 		USoundWave* SoundWave = WidgetCommon::NewObject<USoundWave>(SoundPath);
  93. 		FSlateSound SlateSound;
  94. 		SlateSound.SetResourceObject(SoundWave);
  95. 		return SlateSound;
  96. 	}
  97.  
  98. 	/**
  99. 	* 创建按钮样式
  100. 	*	@param {Normal}					普通
  101. 	*	@param {Hovered}				已悬停
  102. 	*	@param {Pressed}				已按压
  103. 	*	@param {Disabled}				已禁用
  104. 	*	@param {NormalForeground}		正常前景
  105. 	*	@param {HoveredForeground}		悬停的前景
  106. 	*	@param {PressedForeground}		按下的前景
  107. 	*	@param {DisabledForeground}		禁用的前景
  108. 	*	@param {NormalPadding}			普通填充（左、上、右、下）
  109. 	*	@param {PressedPadding}			按压填充（左、上、右、下）
  110. 	*	@param {PressedSound}			按压音效
  111. 	*	@param {HoveredSound}			悬停音效
  112. 	*/
  113. 	static FButtonStyle CreateButtonStyle(const FSlateBrush& Normal, const FSlateBrush& Hovered, const FSlateBrush& Pressed, const FSlateBrush& Disabled, const FSlateColor& NormalForeground, const FSlateColor& HoveredForeground, const FSlateColor& PressedForeground, const FSlateColor& DisabledForeground, const FMargin& NormalPadding, const FMargin& PressedPadding, const FSlateSound& PressedSound, const FSlateSound& HoveredSound) {
  114. 		FButtonStyle ButtonStyle;
  115. 		ButtonStyle.SetNormal(Normal);
  116. 		ButtonStyle.SetHovered(Hovered);
  117. 		ButtonStyle.SetPressed(Pressed);
  118. 		ButtonStyle.SetDisabled(Disabled);
  119. 		ButtonStyle.SetNormalForeground(NormalForeground);
  120. 		ButtonStyle.SetHoveredForeground(HoveredForeground);
  121. 		ButtonStyle.SetPressedForeground(PressedForeground);
  122. 		ButtonStyle.SetDisabledForeground(DisabledForeground);
  123. 		ButtonStyle.SetNormalPadding(NormalPadding);
  124. 		ButtonStyle.SetPressedPadding(PressedPadding);
  125. 		ButtonStyle.SetPressedSound(PressedSound);
  126. 		ButtonStyle.SetHoveredSound(HoveredSound);
  127. 		return ButtonStyle;
  128. 	}
  129.  
  130. 	/**
  131. 	* 创建勾选框样式
  132. 	*	@param {CheckBoxType}							勾选框类型
  133. 	*		ESlateCheckBoxType::Type::CheckBox				勾选框
  134. 	*		ESlateCheckBoxType::Type::ToggleButton			切换按键
  135. 	*	@param {UncheckedImage}							未勾选图像
  136. 	*	@param {UncheckedHoveredImage}					未勾选悬停图像
  137. 	*	@param {UncheckedPressedImage}					未勾选按压图像
  138. 	*	@param {CheckedImage}							已勾选图像
  139. 	*	@param {CheckedHoveredImage}					已勾选悬停图像
  140. 	*	@param {CheckedPressedImage}					已勾选按压图像
  141. 	*	@param {UndeterminedImage}						未确定图像
  142. 	*	@param {UndeterminedHoveredImage}				未确定悬停图像
  143. 	*	@param {UndeterminedPressedImage}				未确定按压图像
  144. 	*	@param {Padding}								填充
  145. 	*	@param {BackgroundImage}						背景图片
  146. 	*	@param {BackgroundHoveredImage}					背景悬停图片
  147. 	*	@param {BackgroundPressedImage}					背景按下图像
  148. 	*	@param {ForegroundColor}						前景颜色
  149. 	*	@param {HoveredForeground}						悬停前景
  150. 	*	@param {PressedForeground}						按下前景
  151. 	*	@param {CheckedForeground}						格子前景
  152. 	*	@param {CheckedHoveredForeground}				格子悬停前景
  153. 	*	@param {CheckedPressedForeground}				格子按下前景
  154. 	*	@param {UndeterminedForeground}					未确定的前景
  155. 	*	@param {BorderBackgroundColor}					边界背景颜色
  156. 	*	@param {CheckedSound}							已勾选音效
  157. 	*	@param {UncheckedSound}							未勾选音效
  158. 	*	@param {HoveredSound}							悬停音效
  159. 	*/
  160. 	static FCheckBoxStyle CreateCheckBoxStyle(const ESlateCheckBoxType::Type& CheckBoxType, const FSlateBrush& UncheckedImage, const FSlateBrush& UncheckedHoveredImage, const FSlateBrush& UncheckedPressedImage, const FSlateBrush& CheckedImage, const FSlateBrush& CheckedHoveredImage, const FSlateBrush& CheckedPressedImage, const FSlateBrush& UndeterminedImage, const FSlateBrush& UndeterminedHoveredImage, const FSlateBrush& UndeterminedPressedImage, const FMargin& Padding, const FSlateBrush& BackgroundImage, const FSlateBrush& BackgroundHoveredImage, const FSlateBrush& BackgroundPressedImage, const FSlateColor& ForegroundColor, const FSlateColor& HoveredForeground, const FSlateColor& PressedForeground, const FSlateColor& CheckedForeground, const FSlateColor& CheckedHoveredForeground, const FSlateColor& CheckedPressedForeground, const FSlateColor& UndeterminedForeground, const FSlateColor& BorderBackgroundColor, const FSlateSound& CheckedSound, const FSlateSound& UncheckedSound, const FSlateSound& HoveredSound) {
  161. 		FCheckBoxStyle CheckBoxStyle;
  162. 		CheckBoxStyle.SetCheckBoxType(CheckBoxType);
  163. 		CheckBoxStyle.SetUncheckedImage(UncheckedImage);
  164. 		CheckBoxStyle.SetUncheckedHoveredImage(UncheckedHoveredImage);
  165. 		CheckBoxStyle.SetUncheckedPressedImage(UncheckedPressedImage);
  166. 		CheckBoxStyle.SetCheckedImage(CheckedImage);
  167. 		CheckBoxStyle.SetCheckedHoveredImage(CheckedHoveredImage);
  168. 		CheckBoxStyle.SetCheckedPressedImage(CheckedPressedImage);
  169. 		CheckBoxStyle.SetUndeterminedImage(UndeterminedImage);
  170. 		CheckBoxStyle.SetUndeterminedHoveredImage(UndeterminedHoveredImage);
  171. 		CheckBoxStyle.SetUndeterminedPressedImage(UndeterminedPressedImage);
  172. 		CheckBoxStyle.SetPadding(Padding);
  173. 		CheckBoxStyle.SetBackgroundImage(BackgroundImage);
  174. 		CheckBoxStyle.SetBackgroundHoveredImage(BackgroundHoveredImage);
  175. 		CheckBoxStyle.SetBackgroundPressedImage(BackgroundPressedImage);
  176. 		CheckBoxStyle.SetForegroundColor(ForegroundColor);
  177. 		CheckBoxStyle.SetHoveredForegroundColor(HoveredForeground);
  178. 		CheckBoxStyle.SetPressedForegroundColor(PressedForeground);
  179. 		CheckBoxStyle.SetCheckedForegroundColor(CheckedForeground);
  180. 		CheckBoxStyle.SetCheckedHoveredForegroundColor(CheckedHoveredForeground);
  181. 		CheckBoxStyle.SetCheckedPressedForegroundColor(CheckedPressedForeground);
  182. 		CheckBoxStyle.SetUndeterminedForegroundColor(UndeterminedForeground);
  183. 		CheckBoxStyle.SetBorderBackgroundColor(BorderBackgroundColor);
  184. 		CheckBoxStyle.SetCheckedSound(CheckedSound);
  185. 		CheckBoxStyle.SetUncheckedSound(UncheckedSound);
  186. 		CheckBoxStyle.SetHoveredSound(HoveredSound);
  187. 		return CheckBoxStyle;
  188. 	}
  189.  
  190. 	/**
  191. 	* 创建滚动条样式
  192. 	*	@param {HorizontalBackgroundImage}			水平背景图
  193. 	*	@param {VerticalBackgroundImage}			垂直背景图
  194. 	*	@param {VerticalTopSlotImage}				垂直顶部插槽图像
  195. 	*	@param {HorizontalTopSlotImage}				水平顶部插槽图像
  196. 	*	@param {VerticalBottomSlotImage}			垂直底部插槽图像
  197. 	*	@param {HorizontalBottomSlotImage}			水平底部插槽图像
  198. 	*	@param {NormalThumbImage}					正常的缩略图
  199. 	*	@param {HoveredThumbImage}					悬浮的缩略图
  200. 	*	@param {DraggedThumbImage}					拖动的缩略图
  201. 	*	@param {Thickness}							厚度
  202. 	*/
  203. 	static FScrollBarStyle CreateScrollBarStyle(const FSlateBrush& HorizontalBackgroundImage, const FSlateBrush& VerticalBackgroundImage, const FSlateBrush& VerticalTopSlotImage, const FSlateBrush& HorizontalTopSlotImage, const FSlateBrush& VerticalBottomSlotImage, const FSlateBrush& HorizontalBottomSlotImage, const FSlateBrush& NormalThumbImage, const FSlateBrush& HoveredThumbImage, const FSlateBrush& DraggedThumbImage, const float& Thickness) {
  204. 		FScrollBarStyle ScrollBarStyle;
  205. 		ScrollBarStyle.SetHorizontalBackgroundImage(HorizontalBackgroundImage);
  206. 		ScrollBarStyle.SetVerticalBackgroundImage(VerticalBackgroundImage);
  207. 		ScrollBarStyle.SetVerticalTopSlotImage(VerticalTopSlotImage);
  208. 		ScrollBarStyle.SetHorizontalTopSlotImage(HorizontalTopSlotImage);
  209. 		ScrollBarStyle.SetVerticalBottomSlotImage(VerticalBottomSlotImage);
  210. 		ScrollBarStyle.SetHorizontalBottomSlotImage(HorizontalBottomSlotImage);
  211. 		ScrollBarStyle.SetNormalThumbImage(NormalThumbImage);
  212. 		ScrollBarStyle.SetHoveredThumbImage(HoveredThumbImage);
  213. 		ScrollBarStyle.SetDraggedThumbImage(DraggedThumbImage);
  214. 		ScrollBarStyle.SetThickness(Thickness);
  215. 		return ScrollBarStyle;
  216. 	}
  217. };

WidgetBase.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/PanelWidget.h"
  6. #include "Kismet2/BlueprintEditorUtils.h"
  7.  
  8.  
  9. template <typename WidgetT = UWidget>
  10. class WidgetBase {
  11. public:
  12. 	UWidgetBlueprint* WidgetBlueprint;
  13. 	WidgetT* Widget;
  14.  
  15. public:
  16. 	WidgetBase(UWidgetBlueprint* WidgetBlueprint) : WidgetBlueprint(WidgetBlueprint), Widget(nullptr) {}
  17.  
  18. 	WidgetBase(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName): WidgetBlueprint(WidgetBlueprint), Widget(WidgetBlueprint->WidgetTree->ConstructWidget<WidgetT>(WidgetT::StaticClass(), WidgetName)) {}
  19. 	
  20. 	virtual ~WidgetBase() {}
  21.  
  22. public:
  23. 	virtual UWidget* FindWidget(const FName& WidgetName) {
  24. 		return this->WidgetBlueprint->WidgetTree->FindWidget(WidgetName);
  25. 	}
  26.  
  27. 	virtual void AddToRoot() const noexcept {
  28. 		this->WidgetBlueprint->WidgetTree->RootWidget = this->Widget;
  29. 	}
  30.  
  31. 	virtual UPanelWidget* GetParent() const noexcept {
  32. 		return this->Widget->GetParent();
  33. 	}
  34.  
  35. 	virtual void RemoveFromParent() {
  36. 		this->Widget->RemoveFromParent();
  37. 	}
  38.  
  39. 	// 是变量
  40. 	virtual void SetIsVariable(bool IsVariable) {
  41. 		this->Widget->bIsVariable = IsVariable;
  42. 	}
  43.  
  44. 	// 行为 - 工具提示文本
  45. 	virtual void SetToolTipText(const FText& ToolTipText) {
  46. 		this->Widget->SetToolTipText(ToolTipText);
  47. 	}
  48.  
  49. 	/**
  50. 	* 行为 - 已启用
  51. 	*	设置此控件能否被用户交互修改
  52. 	*/
  53. 	virtual void SetIsEnabled(bool IsEnabled) {
  54. 		this->Widget->SetIsEnabled(IsEnabled);
  55. 	}
  56.  
  57. 	/**
  58. 	* 行为 - 可视性。
  59. 	*	ESlateVisibility::Visible					(可视)
  60. 	*	ESlateVisibility::Collapsed					(已折叠)
  61. 	*	ESlateVisibility::Hidden					(隐藏)
  62. 	*	ESlateVisibility::HitTestInvisible			(非可命中测试(自身和所有子项))
  63. 	*	ESlateVisibility::SelfHitTestInvisible		(非可命中测试(仅自身))
  64. 	*/
  65. 	virtual void SetVisibility(const ESlateVisibility& Visibility) {
  66. 		this->Widget->SetVisibility(Visibility);
  67. 	}
  68.  
  69. 	// 行为 - 渲染不透明度
  70. 	virtual void SetRenderOpacity(const float& RenderOpacity) {
  71. 		this->Widget->SetRenderOpacity(RenderOpacity);
  72. 	}
  73.  
  74. 	/**
  75. 	* 行为 - 高级 - 光标
  76. 	*	EMouseCursor::Type::None					(无)
  77. 	*	EMouseCursor::Type::Default					(默认)
  78. 	*	EMouseCursor::Type::TextEditBeam			(文本编辑光束)
  79. 	*	EMouseCursor::Type::ResizeLeftRight			(调整左右大小)
  80. 	*	EMouseCursor::Type::ResizeUpDown			(调整上下大小)
  81. 	*	EMouseCursor::Type::ResizeSouthEast			(调整南东大小)
  82. 	*	EMouseCursor::Type::ResizeSouthWest			(调整南西大小)
  83. 	*	EMouseCursor::Type::CardinalCross			(十字架)
  84. 	*	EMouseCursor::Type::Crosshairs				(十字准星)
  85. 	*	EMouseCursor::Type::Hand					(手)
  86. 	*	EMouseCursor::Type::GrabHand				(手抓取)
  87. 	*	EMouseCursor::Type::GrabHandClosed			(手抓取关闭)
  88. 	*	EMouseCursor::Type::SlashedCircle			(斜园)
  89. 	*	EMouseCursor::Type::EyeDropper				(滴管)
  90. 	*	EMouseCursor::Type::Custom					(自定义)
  91. 	*/
  92. 	virtual void SetCursor(const EMouseCursor::Type& Cursor) {
  93. 		this->Widget->SetCursor(Cursor);
  94. 	}
  95.  
  96. 	/**
  97. 	渲染变换
  98. 	*	@param {Translation}  变换 - 平移
  99. 	*	@param {Scale}  变换 - 缩放
  100. 	*	@param {Shear}  变换 - 修剪
  101. 	*	@param {Angle}  变换 - 角度
  102. 	*	@param {Pivot}	枢轴
  103. 	*/
  104. 	virtual void SetRender(const FVector2D& Translation, const FVector2D& Scale, const FVector2D& Shear, const float& Angle, const FVector2D& Pivot) {
  105. 		FWidgetTransform Transform = FWidgetTransform(Translation, Scale, Shear, Angle);
  106. 		this->Widget->SetRenderTransform(Transform);
  107. 		// this->Widget->SetRenderTranslation(Translation);
  108. 		// this->Widget->SetRenderScale(Scale);
  109. 		// this->Widget->SetRenderShear(Shear);
  110. 		// this->Widget->SetRenderTransformAngle(Angle);
  111. 		this->Widget->SetRenderTransformPivot(Pivot);
  112. 	}
  113.  
  114. 	// 性能 - 为易变
  115. 	virtual void ForceVolatile(bool Force) {
  116. 		this->Widget->ForceVolatile(Force);
  117. 	}
  118.  
  119. 	/**
  120. 	* 裁剪 - 剪切
  121. 	*	EWidgetClipping::Inherit							(继承)
  122. 	*	EWidgetClipping::ClipToBounds						(剪切到边界)
  123. 	*	EWidgetClipping::ClipToBoundsWithoutIntersecting	(剪切到边界 - 无交互(高级))
  124. 	*	EWidgetClipping::ClipToBoundsAlways					(剪切到边界 - 固定(高级))
  125. 	*	EWidgetClipping::OnDemand							(按需(高级))
  126. 	*/
  127. 	virtual void SetClipping(const EWidgetClipping& Clipping) {
  128. 		this->Widget->SetClipping(Clipping);
  129. 	}
  130.  
  131. public:
  132. 	void AddInterface(const FName& InterfaceName) {
  133. 		const UClass* InterfaceClass = Cast<UClass>(StaticFindObject(UClass::StaticClass(), ANY_PACKAGE, *InterfaceName.ToString()));
  134. 		bool bIsExist = false;
  135. 		for (auto InterfaceItem : this->WidgetBlueprint->ImplementedInterfaces) {
  136. 			if (InterfaceItem.Interface == InterfaceClass) {
  137. 				bIsExist = true;
  138. 				break;
  139. 			}
  140. 		}
  141. 		if (!bIsExist) {
  142. 			FBlueprintEditorUtils::ImplementNewInterface(this->WidgetBlueprint, InterfaceName);
  143. 		}
  144. 	}
  145. };

WidgetPanel.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/PanelWidget.h"
  6. #include "WidgetBase.hpp"
  7.  
  8.  
  9. template <typename WidgetT = UPanelWidget>
  10. class WidgetPanel : public WidgetBase<WidgetT> {
  11. public:
  12. 	WidgetPanel(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	virtual ~WidgetPanel() {}
  15.  
  16. public:
  17. 	virtual void AddChild(UWidget* ChildWidget) {
  18. 		this->Widget->AddChild(ChildWidget);
  19. 	}
  20.  
  21. 	virtual void RemoveChild(UWidget* ChildWidget) {
  22. 		this->Widget->RemoveChild(ChildWidget);
  23. 	}
  24. };

WidgetContent.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/ContentWidget.h"
  6. #include "WidgetPanel.hpp"
  7.  
  8.  
  9. template <typename WidgetT = UContentWidget>
  10. class WidgetContent : public WidgetPanel<WidgetT> {
  11. public:
  12. 	WidgetContent(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	virtual ~WidgetContent() {}
  15.  
  16. public:
  17. 	virtual void SetContent(UWidget* ChildWidget) {
  18. 		this->Widget->SetContent(ChildWidget);
  19. 	}
  20. };

1、面板类型组件

WidgetCanvasPanel.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/CanvasPanel.h"
  6. #include "Components/CanvasPanelSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetCanvasPanel : public WidgetPanel<UCanvasPanel> {
  11. public:
  12. 	WidgetCanvasPanel(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetCanvasPanel() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(画布面板插槽)
  19. 	*	@param {ChildWidget}	插槽中的Widget。
  20. 	*	@param {Anchors}		锚点 (最小X、 最小Y、 最大X、 最大Y)
  21. 	*	@param {Position}		位置 (位置X(偏移左侧)、 位置Y(偏移顶部))
  22. 	*	@param {Size}			尺寸 (尺寸X(偏移右侧)、尺寸Y（偏移底部))
  23. 	*	@param {Alignment}		对齐
  24. 	*	@param {AutoSize}		大小到内容
  25. 	*	@param {ZOrder}			ZOrder
  26. 	*/
  27. 	void SetSlot(UWidget* ChildWidget, const FAnchors& Anchors, const FVector2D& Position, const FVector2D& Size, const FVector2D& Alignment, bool AutoSize, const int32& ZOrder) {
  28. 		UCanvasPanelSlot* Slot = Cast<UCanvasPanelSlot>(ChildWidget->Slot);
  29. 		FAnchorData AnchorData;
  30. 		FMargin Margin(Position.X, Position.Y, Size.X, Size.Y);
  31. 		AnchorData.Offsets = Margin;
  32. 		AnchorData.Anchors = Anchors;
  33. 		AnchorData.Alignment = Alignment;
  34. 		Slot->SetLayout(AnchorData);
  35. 		// Slot->SetAnchors(Anchors);
  36. 		// Slot->SetPosition(Position);
  37. 		// Slot->SetSize(Size);
  38. 		// Slot->SetAlignment(Alignment);
  39. 		Slot->SetAutoSize(AutoSize);
  40. 		Slot->SetZOrder(ZOrder);
  41. 	}
  42. };

WidgetOverlay.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/Overlay.h"
  6. #include "Components/OverlaySlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetOverlay : public WidgetPanel<UOverlay> {
  11. public:
  12. 	WidgetOverlay(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetOverlay() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(覆层插槽)
  19. 	*	@param {ChildWidget}	                    插槽中的Widget。
  20. 	*	@param {Padding}		                    填充 (左、 上、 右、 下)
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*	@param {VerticalAlignment}					垂直对齐
  27. 	*		EVerticalAlignment::VAlign_Top				向上
  28. 	*		EVerticalAlignment::VAlign_Center			居中
  29. 	*		EVerticalAlignment::VAlign_Bottom			向下
  30. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  31. 	*/
  32. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  33. 		UOverlaySlot* Slot = Cast<UOverlaySlot>(ChildWidget->Slot);
  34. 		Slot->SetPadding(Padding);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 	}
  38. };

WidgetHorizontalBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/HorizontalBox.h"
  6. #include "Components/HorizontalBoxSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetHorizontalBox : public WidgetPanel<UHorizontalBox> {
  11. public:
  12. 	WidgetHorizontalBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetHorizontalBox() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(水平框插槽)
  19. 	*	@param {ChildWidget}	                        插槽中的Widget。
  20. 	*	@param {Padding}		                        填充 (左、 上、 右、 下)
  21. 	*	@param {Size}									尺寸
  22. 	*		FSlateChildSize(ESlateSizeRule::Automatic)		自动
  23. 	*		FSlateChildSize(ESlateSizeRule::Fill)			填充(默认为1.0，如需更改，设置 Value 值。)
  24. 	*	@param {HorizontalAlignment}				    水平对齐
  25. 	*		EHorizontalAlignment::HAlign_Left			    向左
  26. 	*		EHorizontalAlignment::HAlign_Center			    居中
  27. 	*		EHorizontalAlignment::HAlign_Right			    向右
  28. 	*		EHorizontalAlignment::HAlign_Fill			    水平填充
  29. 	*	@param {VerticalAlignment}					    垂直对齐
  30. 	*		EVerticalAlignment::VAlign_Top				    向上
  31. 	*		EVerticalAlignment::VAlign_Center			    居中
  32. 	*		EVerticalAlignment::VAlign_Bottom			    向下
  33. 	*		EVerticalAlignment::VAlign_Fill				    垂直填充
  34. 	*/
  35. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const FSlateChildSize& Size, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  36. 		UHorizontalBoxSlot* Slot = Cast<UHorizontalBoxSlot>(ChildWidget->Slot);
  37. 		Slot->SetPadding(Padding);
  38. 		Slot->SetSize(Size);
  39. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  40. 		Slot->SetVerticalAlignment(VerticalAlignment);
  41. 	}
  42. };

WidgetVerticalBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/VerticalBox.h"
  6. #include "Components/VerticalBoxSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetVerticalBox : public WidgetPanel<UVerticalBox> {
  11. public:
  12. 	WidgetVerticalBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetVerticalBox() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(垂直框插槽)
  19. 	*	@param {ChildWidget}	                        插槽中的Widget。
  20. 	*	@param {Padding}		                        填充 (左、 上、 右、 下)
  21. 	*	@param {Size}									尺寸
  22. 	*		FSlateChildSize(ESlateSizeRule::Automatic)		自动
  23. 	*		FSlateChildSize(ESlateSizeRule::Fill)			填充(默认为1.0，如需更改，设置 Value 值。)
  24. 	*	@param {HorizontalAlignment}				    水平对齐
  25. 	*		EHorizontalAlignment::HAlign_Left			    向左
  26. 	*		EHorizontalAlignment::HAlign_Center			    居中
  27. 	*		EHorizontalAlignment::HAlign_Right			    向右
  28. 	*		EHorizontalAlignment::HAlign_Fill			    水平填充
  29. 	*	@param {VerticalAlignment}					    垂直对齐
  30. 	*		EVerticalAlignment::VAlign_Top				    向上
  31. 	*		EVerticalAlignment::VAlign_Center			    居中
  32. 	*		EVerticalAlignment::VAlign_Bottom			    向下
  33. 	*		EVerticalAlignment::VAlign_Fill				    垂直填充
  34. 	*/
  35. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const FSlateChildSize& Size, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  36. 		UVerticalBoxSlot* Slot = Cast<UVerticalBoxSlot>(ChildWidget->Slot);
  37. 		Slot->SetPadding(Padding);
  38. 		Slot->SetSize(Size);
  39. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  40. 		Slot->SetVerticalAlignment(VerticalAlignment);
  41. 	}
  42. };

WidgetUniformGridPanel.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/UniformGridPanel.h"
  6. #include "Components/UniformGridSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetUniformGridPanel : public WidgetPanel<UUniformGridPanel> {
  11. public:
  12. 	WidgetUniformGridPanel(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetUniformGridPanel() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(统一网格插槽)
  19. 	*	@param {ChildWidget}	                    插槽中的Widget。
  20. 	*	@param {HorizontalAlignment}				水平对齐
  21. 	*		EHorizontalAlignment::HAlign_Left			向左
  22. 	*		EHorizontalAlignment::HAlign_Center			居中
  23. 	*		EHorizontalAlignment::HAlign_Right			向右
  24. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  25. 	*	@param {VerticalAlignment}					垂直对齐
  26. 	*		EVerticalAlignment::VAlign_Top				向上
  27. 	*		EVerticalAlignment::VAlign_Center			居中
  28. 	*		EVerticalAlignment::VAlign_Bottom			向下
  29. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  30. 	*	@param {Row}		行
  31. 	*	@param {Column}		列
  32. 	*/
  33. 	void SetSlot(UWidget* ChildWidget, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment, const int32& Row, const int32& Column) {
  34. 		UUniformGridSlot* Slot = Cast<UUniformGridSlot>(ChildWidget->Slot);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 		Slot->SetRow(Row);
  38. 		Slot->SetColumn(Column);
  39. 	}
  40.  
  41. 	/**
  42. 	* 子布局
  43. 	*	@param {SlotPadding}			插槽填充(左、上、右、下)
  44. 	*	@param {MinDesiredSlotWidth}	所需最小插槽宽度
  45. 	*	@param {MinDesiredSlotHeight}	所需最小插槽高度
  46. 	*/
  47. 	void SetSubLayout(const FMargin& SlotPadding, const float& MinDesiredSlotWidth, const float& MinDesiredSlotHeight) {
  48. 		this->Widget->SetSlotPadding(SlotPadding);
  49. 		this->Widget->SetMinDesiredSlotWidth(MinDesiredSlotWidth);
  50. 		this->Widget->SetMinDesiredSlotHeight(MinDesiredSlotHeight);
  51. 	}
  52. };

WidgetScrollBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/ScrollBox.h"
  6. #include "Components/ScrollBoxSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetScrollBox : public WidgetPanel<UScrollBox> {
  11. public:
  12. 	WidgetScrollBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetScrollBox() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(滚动框插槽)
  19. 	*	@param {ChildWidget}	                    插槽中的Widget。
  20. 	*	@param {Padding}		                    填充 (左、 上、 右、 下)
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*	@param {VerticalAlignment}					垂直对齐
  27. 	*		EVerticalAlignment::VAlign_Top				向上
  28. 	*		EVerticalAlignment::VAlign_Center			居中
  29. 	*		EVerticalAlignment::VAlign_Bottom			向下
  30. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  31. 	*/
  32. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  33. 		UScrollBoxSlot* Slot = Cast<UScrollBoxSlot>(ChildWidget->Slot);
  34. 		Slot->SetPadding(Padding);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 	}
  38.  
  39. 	/**
  40. 	* 滚动
  41. 	*	@param {Orientation}							朝向
  42. 	*		EOrientation::Orient_Horizontal					水平
  43. 	*		EOrientation::Orient_Vertical					垂直
  44. 	*	@param {ScrollBarVisibility}					滚动条可视性
  45. 	*		ESlateVisibility::Visible						可视
  46. 	*		ESlateVisibility::Collapsed						已折叠
  47. 	*		ESlateVisibility::Hidden						隐藏)
  48. 	*		ESlateVisibility::HitTestInvisible				非可命中测试(自身和所有子项)
  49. 	*		ESlateVisibility::SelfHitTestInvisible			非可命中测试(仅自身)
  50. 	*	@param {ConsumeMouseWheel}						消耗鼠标滚轮
  51. 	*		EConsumeMouseWheel::WhenScrollingPossible		可以滚动时
  52. 	*		EConsumeMouseWheel::Always						固定
  53. 	*		EConsumeMouseWheel::Never						永不
  54. 	*	@param {ScrollbarThickness}						滚动条厚度(X, Y)
  55. 	*	@param {ScrollbarPadding}						滚动条填充(左、上、右、下)
  56. 	*	@param {AlwaysShowScrollbar}					固定显示滚动条
  57. 	*	@param {AllowOverscroll}						允许过度滚动
  58. 	*	@param {ShouldAnimateWheelScrolling}			动画滚轮滚动
  59. 	*	@param {NavigationDestination}					导航目标
  60. 	*		EDescendantScrollDestination::IntoView			进入视图
  61. 	*		EDescendantScrollDestination::TopOrLeft			顶部或左侧
  62. 	*		EDescendantScrollDestination::Center			居中
  63. 	*		EDescendantScrollDestination::BottomOrRight		底部或右侧
  64. 	*	@param {ScrollWhenFocusChanges}					聚焦变化时滚动
  65. 	*		EScrollWhenFocusChanges::NoScroll				无滚动
  66. 	*		EScrollWhenFocusChanges::InstantScroll			即时滚动
  67. 	*		EScrollWhenFocusChanges::AnimatedScroll			动画滚动
  68. 	*	@param {WheelScrollMultiplier}					滚轮滚动乘数
  69. 	*/
  70. 	void SetScroll(const EOrientation& Orientation, const ESlateVisibility& ScrollBarVisibility, const EConsumeMouseWheel& ConsumeMouseWheel, const FVector2D& ScrollbarThickness, const FMargin& ScrollbarPadding, bool AlwaysShowScrollbar, bool AllowOverscroll, bool ShouldAnimateWheelScrolling, const EDescendantScrollDestination& NavigationDestination, const EScrollWhenFocusChanges& ScrollWhenFocusChanges, const float& WheelScrollMultiplier) {
  71. 		this->Widget->SetOrientation(Orientation);
  72. 		this->Widget->SetScrollBarVisibility(ScrollBarVisibility);
  73. 		this->Widget->SetConsumeMouseWheel(ConsumeMouseWheel);
  74. 		this->Widget->SetScrollbarThickness(ScrollbarThickness);
  75. 		this->Widget->SetScrollbarPadding(ScrollbarPadding);
  76. 		this->Widget->SetAlwaysShowScrollbar(AlwaysShowScrollbar);
  77. 		this->Widget->SetAllowOverscroll(AllowOverscroll);
  78. 		this->Widget->SetAnimateWheelScrolling(ShouldAnimateWheelScrolling);
  79. 		this->Widget->SetNavigationDestination(NavigationDestination);
  80. 		this->Widget->SetScrollWhenFocusChanges(ScrollWhenFocusChanges);
  81. 		this->Widget->SetWheelScrollMultiplier(WheelScrollMultiplier);
  82. 	}
  83. };

WidgetSizeBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/SizeBox.h"
  6. #include "Components/SizeBoxSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetSizeBox : public WidgetPanel<USizeBox> {
  11. public:
  12. 	WidgetSizeBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetSizeBox() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(尺寸框插槽)
  19. 	*	@param {ChildWidget}	插槽中的Widget。
  20. 	*	@param {Padding}		填充 (左、 上、 右、 下)
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*	@param {VerticalAlignment}					垂直对齐
  27. 	*		EVerticalAlignment::VAlign_Top				向上
  28. 	*		EVerticalAlignment::VAlign_Center			居中
  29. 	*		EVerticalAlignment::VAlign_Bottom			向下
  30. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  31. 	*/
  32. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  33. 		USizeBoxSlot* Slot = Cast<USizeBoxSlot>(ChildWidget->Slot);
  34. 		Slot->SetPadding(Padding);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 	}
  38.  
  39. 	/**
  40. 	* 子布局
  41. 	*	@param {WidthOverride}			宽度重载
  42. 	*	@param {HeightOverride}			高度重载
  43. 	*	@param {MinDesiredWidth}		所需最小宽度
  44. 	*	@param {MinDesiredHeight}		所需最小高度
  45. 	*	@param {MaxDesiredWidth}		所需最大宽度
  46. 	*	@param {MaxDesiredHeight}		所需最大高度
  47. 	*	@param {MinAspectRatio}			最小高宽比
  48. 	*	@param {MaxAspectRatio}			最大高宽比
  49. 	*/
  50. 	void SetSubLayout(const float& WidthOverride, const float& HeightOverride, const float& MinDesiredWidth, const float& MinDesiredHeight, const float& MaxDesiredWidth, const float& MaxDesiredHeight, const float& MinAspectRatio, const float& MaxAspectRatio) {
  51. 		this->Widget->SetWidthOverride(WidthOverride);
  52. 		this->Widget->SetHeightOverride(HeightOverride);
  53. 		this->Widget->SetMinDesiredWidth(MinDesiredWidth);
  54. 		this->Widget->SetMinDesiredHeight(MinDesiredHeight);
  55. 		this->Widget->SetMaxDesiredWidth(MaxDesiredWidth);
  56. 		this->Widget->SetMaxDesiredHeight(MaxDesiredHeight);
  57. 		this->Widget->SetMinAspectRatio(MinAspectRatio);
  58. 		this->Widget->SetMaxAspectRatio(MaxAspectRatio);
  59. 	}
  60. };

WidgetSwitcher.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/WidgetSwitcher.h"
  6. #include "Components/WidgetSwitcherSlot.h"
  7. #include "WidgetPanel.hpp"
  8.  
  9.  
  10. class WidgetSwitcher : public WidgetPanel<UWidgetSwitcher> {
  11. public:
  12. 	WidgetSwitcher(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetPanel(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetSwitcher() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(控件切换器插槽)
  19. 	*	@param {ChildWidget}	插槽中的Widget。
  20. 	*	@param {Padding}		填充 (左、 上、 右、 下)
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*	@param {VerticalAlignment}					垂直对齐
  27. 	*		EVerticalAlignment::VAlign_Top				向上
  28. 	*		EVerticalAlignment::VAlign_Center			居中
  29. 	*		EVerticalAlignment::VAlign_Bottom			向下
  30. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  31. 	*/
  32. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  33. 		UWidgetSwitcherSlot* Slot = Cast<UWidgetSwitcherSlot>(ChildWidget->Slot);
  34. 		Slot->SetPadding(Padding);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 	}
  38.  
  39. 	/**
  40. 	* 切换器
  41. 	*	@param {ActiveWidgetIndex}		激活控件索引
  42. 	*/
  43. 	void SetSwitcher(const int32& ActiveWidgetIndex) {
  44. 		this->Widget->SetActiveWidgetIndex(ActiveWidgetIndex);
  45. 	}
  46.  
  47. 	/**
  48. 	* 切换器
  49. 	*	@param {ActiveWidget}			激活控件
  50. 	*/
  51. 	void SetSwitcher(UWidget* ActiveWidget) {
  52. 		this->Widget->SetActiveWidget(ActiveWidget);
  53. 	}
  54. };

WidgetScaleBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/ScaleBox.h"
  6. #include "Components/ScaleBoxSlot.h"
  7. #include "WidgetContent.hpp"
  8.  
  9.  
  10. class WidgetScaleBox : public WidgetContent<UScaleBox> {
  11. public:
  12. 	WidgetScaleBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetScaleBox() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(缩放框插槽)
  19. 	*	@param {ChildWidget}	                    插槽中的Widget。
  20. 	*	@param {Padding}		                    填充 (左、 上、 右、 下)
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*	@param {VerticalAlignment}					垂直对齐
  27. 	*		EVerticalAlignment::VAlign_Top				向上
  28. 	*		EVerticalAlignment::VAlign_Center			居中
  29. 	*		EVerticalAlignment::VAlign_Bottom			向下
  30. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  31. 	*/
  32. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  33. 		UScaleBoxSlot* Slot = Cast<UScaleBoxSlot>(ChildWidget->Slot);
  34. 		Slot->SetPadding(Padding);
  35. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  36. 		Slot->SetVerticalAlignment(VerticalAlignment);
  37. 	}
  38.  
  39. 	/**
  40. 	* 伸展
  41. 	*	@param {Stretch}					拉伸
  42. 	*		EStretch::Type::None				无
  43. 	*		EStretch::Type::Fill				填充
  44. 	*		EStretch::Type::ScaleToFit			缩放以匹配
  45. 	*		EStretch::Type::ScaleToFitX			缩放以匹配X
  46. 	*		EStretch::Type::ScaleToFitY			缩放以匹配Y
  47. 	*		EStretch::Type::ScaleToFill			缩放以填充
  48. 	*		EStretch::Type::ScaleBySafeZone		按安全区缩放
  49. 	*		EStretch::Type::UserSpecified		用户指定
  50. 	*	@param {StretchDirection}			拉伸方向
  51. 	*		EStretchDirection::Type::Both		两者
  52. 	*		EStretchDirection::Type::DownOnly	仅向下
  53. 	*		EStretchDirection::Type::UpOnly		仅向上
  54. 	*	@param {UserSpecifiedScale}			用户指定缩放
  55. 	*	@param {IgnoreInheritedScale}		忽略继承的缩放
  56. 	*/
  57. 	void SetStretch(const EStretch::Type& Stretch, const EStretchDirection::Type& StretchDirection, const float& UserSpecifiedScale, bool IgnoreInheritedScale) {
  58. 		this->Widget->SetStretch(Stretch);
  59. 		this->Widget->SetStretchDirection(StretchDirection);
  60. 		this->Widget->SetUserSpecifiedScale(UserSpecifiedScale);
  61. 		this->Widget->SetIgnoreInheritedScale(IgnoreInheritedScale);
  62. 	}
  63. };

WidgetSafeZone.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Widget.h"
  5. #include "Components/SafeZone.h"
  6. #include "Components/SafeZoneSlot.h"
  7. #include "WidgetContent.hpp"
  8.  
  9.  
  10. class WidgetSafeZone : public WidgetContent<USafeZone> {
  11. public:
  12. 	WidgetSafeZone(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  13.  
  14. 	~WidgetSafeZone() {}
  15.  
  16. public:
  17. 	/**
  18. 	* 插槽(安全区插槽)
  19. 	*	@param {ChildWidget}							插槽中的Widget。
  20. 	*	@param {IsTitleSafe}							为标题安全
  21. 	*	@param {SafeAreaScale}							安全区范围 (左、 上、 右、 下)
  22. 	*	@param {HAlign}									H对齐
  23. 	*		EHorizontalAlignment::HAlign_Left				向左
  24. 	*		EHorizontalAlignment::HAlign_Center				居中
  25. 	*		EHorizontalAlignment::HAlign_Right				向右
  26. 	*		EHorizontalAlignment::HAlign_Fill				水平填充
  27. 	*	@param {VAlign}									V对齐
  28. 	*		EVerticalAlignment::VAlign_Top					向上
  29. 	*		EVerticalAlignment::VAlign_Center				居中
  30. 	*		EVerticalAlignment::VAlign_Bottom				向下
  31. 	*		EVerticalAlignment::VAlign_Fill					垂直填充
  32. 	*	@param {Padding}								填充 (左、 上、 右、 下)
  33. 	*/
  34. 	void SetSlot(UWidget* ChildWidget, bool IsTitleSafe, const FMargin& SafeAreaScale, const EHorizontalAlignment& HAlign, const EVerticalAlignment& VAlign, const FMargin& Padding) {
  35. 		USafeZoneSlot* Slot = Cast<USafeZoneSlot>(ChildWidget->Slot);
  36. 		Slot->bIsTitleSafe = IsTitleSafe;
  37. 		Slot->SafeAreaScale = SafeAreaScale;
  38. 		Slot->HAlign = HAlign;
  39. 		Slot->VAlign = VAlign;
  40. 		Slot->Padding = Padding;
  41. 	}
  42.  
  43. 	/**
  44. 	* 安全区
  45. 	*	@param {PadLeft}		填充左侧
  46. 	*	@param {PadRight}		填充右侧
  47. 	*	@param {PadTop}			填充顶部
  48. 	*	@param {PadBottom}		填充底部
  49. 	*/
  50. 	void SetSidesToPad(bool PadLeft, bool PadRight, bool PadTop, bool PadBottom) {
  51. 		this->Widget->SetSidesToPad(PadLeft, PadRight, PadTop, PadBottom);
  52. 	}
  53. };

2、通用类型组件

WidgetTextBlock.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/TextBlock.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetTextBlock : public WidgetBase<UTextBlock> {
  9. public:
  10. 	WidgetTextBlock(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetTextBlock() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 内容
  17. 	*	@param {Text}	文本。
  18. 	*/
  19. 	void SetText(const FText& Text) {
  20. 		this->Widget->SetText(Text);
  21. 	}
  22.  
  23. 	/**
  24. 	* 外观
  25. 	*	@param {ColorAndOpacity}			颜色和不透明度
  26. 	*	@param {FontInfo}					字体
  27. 	*	@param {StrikeBrush}				删除线
  28. 	*	@param {ShadowOffset}				阴影偏移
  29. 	*	@param {ShadowColorAndOpacity}		阴影颜色
  30. 	*	@param {MinDesiredWidth}			所需最小宽度
  31. 	*	@param {TransformPolicy}			变换规则
  32. 	*		ETextTransformPolicy::None			无
  33. 	*		ETextTransformPolicy::ToLower		到较低
  34. 	*		ETextTransformPolicy::ToUpper		到较高
  35. 	*	@param {Justification}				对齐
  36. 	*		ETextJustify::Type::Left			左
  37. 	*		ETextJustify::Type::Center			中
  38. 	*		ETextJustify::Type::Right			右
  39. 	*/
  40. 	void SetAppearance(const FSlateColor& ColorAndOpacity, const FSlateFontInfo& FontInfo, const FSlateBrush& StrikeBrush, const FVector2D& ShadowOffset, const FLinearColor& ShadowColorAndOpacity, const float& MinDesiredWidth, const ETextTransformPolicy& TransformPolicy, const ETextJustify::Type& Justification) {
  41. 		this->Widget->SetColorAndOpacity(ColorAndOpacity);
  42. 		this->Widget->SetFont(FontInfo);
  43. 		this->Widget->SetStrikeBrush(StrikeBrush);
  44. 		this->Widget->SetShadowOffset(ShadowOffset);
  45. 		this->Widget->SetShadowColorAndOpacity(ShadowColorAndOpacity);
  46. 		this->Widget->SetMinDesiredWidth(MinDesiredWidth);
  47. 		this->Widget->SetTextTransformPolicy(TransformPolicy);
  48. 		this->Widget->SetJustification(Justification);
  49. 	}
  50.  
  51. 	/**
  52. 	* 换行
  53. 	*	@param {AutoTextWrap}								自动包裹文本
  54. 	*/
  55. 	void SetWrap(bool AutoTextWrap) {
  56. 		this->Widget->SetAutoWrapText(AutoTextWrap);
  57. 	}
  58.  
  59. 	/**
  60. 	* 裁剪
  61. 	*	@param {OverflowPolicy}				高级 - 溢出策略
  62. 	*		ETextOverflowPolicy::Clip			剪切
  63. 	*		ETextOverflowPolicy::Ellipsis		省略
  64. 	*/
  65. 	void SetOverflow(const ETextOverflowPolicy& OverflowPolicy) {
  66. 		this->Widget->SetTextOverflowPolicy(OverflowPolicy);
  67. 	}
  68.  
  69. 	/**
  70. 	* 设置不透明度
  71. 	*	@param {Opacity}		不透明度（单独设置 颜色和不透明度 中的不透明度）
  72. 	*/
  73. 	void SetOpacity(const float& Opacity) {
  74. 		this->Widget->SetOpacity(Opacity);
  75. 	}
  76. };

WidgetRichTextBlock.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Engine/DataTable.h"
  5. #include "Components/RichTextBlock.h"
  6. #include "WidgetBase.hpp"
  7.  
  8.  
  9. class WidgetRichTextBlock : public WidgetBase<URichTextBlock> {
  10. public:
  11. 	WidgetRichTextBlock(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  12.  
  13. 	~WidgetRichTextBlock() {}
  14.  
  15. public:
  16. 	/**
  17. 	* 内容
  18. 	*	@param {Text}	文本。
  19. 	*/
  20. 	void SetText(const FText& Text) {
  21. 		this->Widget->SetText(Text);
  22. 	}
  23.  
  24. 	/**
  25. 	* 外观
  26. 	*	@param {TextStyleSet}							文本样式集
  27. 	*	@param {DefaultFont}							默认文本样式覆盖 - 字体
  28. 	*	@param {DefaultColorAndOpacity}					默认文本样式覆盖 - 颜色
  29. 	*	@param {DefaultShadowOffset}					默认文本样式覆盖 - 阴影偏移
  30. 	*	@param {DefaultShadowColorAndOpacity}			默认文本样式覆盖 - 阴影颜色和不透明度
  31. 	*	@param {DefaultSelectedBackgroundColor}			默认文本样式覆盖 - 选定背景颜色
  32. 	*	@param {DefaultHighlightColor}					默认文本样式覆盖 - 高亮颜色
  33. 	*	@param {DefaultHighlightShape}					默认文本样式覆盖 - 高亮形状
  34. 	*	@param {DefaultStrikeBrush}						默认文本样式覆盖 - 删除线
  35. 	*	@param {DefaultUnderlineBrush}					默认文本样式覆盖 - 下划线笔刷
  36. 	*	@param {DefaultTransformPolicy}					默认文本样式覆盖 - 变换规则
  37. 	*		ETextTransformPolicy::None						无
  38. 	*		ETextTransformPolicy::ToLower					到较低
  39. 	*		ETextTransformPolicy::ToUpper					到较高
  40. 	*	@param {DefaultOverflowPolicy}					默认文本样式覆盖 - 溢出策略
  41. 	*		ETextOverflowPolicy::Clip						剪切
  42. 	*		ETextOverflowPolicy::Ellipsis					省略
  43. 	*	@param {MinDesiredWidth}						所需最小宽度
  44. 	*	@param {TransformPolicy}						变换规则
  45. 	*		ETextTransformPolicy::None						无
  46. 	*		ETextTransformPolicy::ToLower					到较低
  47. 	*		ETextTransformPolicy::ToUpper					到较高
  48. 	*	@param {Justification}							对齐
  49. 	*		ETextJustify::Type::Left						左
  50. 	*		ETextJustify::Type::Center						中
  51. 	*		ETextJustify::Type::Right						右
  52. 	*/
  53. 	void SetAppearance(UDataTable* TextStyleSet, const FSlateFontInfo& DefaultFont, const FSlateColor& DefaultColorAndOpacity, const FVector2D& DefaultShadowOffset, const FLinearColor& DefaultShadowColorAndOpacity, const FSlateColor& DefaultSelectedBackgroundColor, const FSlateColor& DefaultHighlightColor, const FSlateBrush& DefaultHighlightShape, const FSlateBrush& DefaultStrikeBrush, const FSlateBrush& DefaultUnderlineBrush, const ETextTransformPolicy& DefaultTransformPolicy, const ETextOverflowPolicy& DefaultOverflowPolicy, const float& MinDesiredWidth, const ETextTransformPolicy& TransformPolicy, const ETextJustify::Type& Justification) {
  54. 		this->Widget->SetTextStyleSet(TextStyleSet);
  55. 		FTextBlockStyle DefaultTextStyle;
  56. 		DefaultTextStyle.SetFont(DefaultFont);
  57. 		DefaultTextStyle.SetColorAndOpacity(DefaultColorAndOpacity);
  58. 		DefaultTextStyle.SetShadowOffset(DefaultShadowOffset);
  59. 		DefaultTextStyle.SetShadowColorAndOpacity(DefaultShadowColorAndOpacity);
  60. 		DefaultTextStyle.SetSelectedBackgroundColor(DefaultSelectedBackgroundColor);
  61. 		DefaultTextStyle.SetHighlightColor(DefaultHighlightColor);
  62. 		DefaultTextStyle.SetHighlightShape(DefaultHighlightShape);
  63. 		DefaultTextStyle.SetStrikeBrush(DefaultStrikeBrush);
  64. 		DefaultTextStyle.SetUnderlineBrush(DefaultUnderlineBrush);
  65. 		DefaultTextStyle.SetTransformPolicy(DefaultTransformPolicy);
  66. 		DefaultTextStyle.SetOverflowPolicy(DefaultOverflowPolicy);
  67. 		this->Widget->SetDefaultTextStyle(DefaultTextStyle);
  68. 		this->Widget->SetMinDesiredWidth(MinDesiredWidth);
  69. 		this->Widget->SetTextTransformPolicy(TransformPolicy);
  70. 		this->Widget->SetJustification(Justification);
  71. 	}
  72.  
  73. 	/**
  74. 	* 换行
  75. 	*	@param {AutoTextWrap}								自动包裹文本
  76. 	*/
  77. 	void SetWrap(bool AutoTextWrap) {
  78. 		this->Widget->SetAutoWrapText(AutoTextWrap);
  79. 	}
  80.  
  81. 	/**
  82. 	* 裁剪
  83. 	*	@param {OverflowPolicy}				高级 - 溢出策略
  84. 	*		ETextOverflowPolicy::Clip			剪切
  85. 	*		ETextOverflowPolicy::Ellipsis		省略
  86. 	*/
  87. 	void SetOverflow(const ETextOverflowPolicy& OverflowPolicy) {
  88. 		this->Widget->SetTextOverflowPolicy(OverflowPolicy);
  89. 	}
  90. };

WidgetImage.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Image.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetImage : public WidgetBase<UImage> {
  9. public:
  10. 	WidgetImage(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetImage() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 外观
  17. 	*	@param {Brush}					笔刷
  18. 	*	@param {ColorAndOpacity}		颜色和不透明度
  19. 	*/
  20. 	void SetAppearance(const FSlateBrush& Brush, const FLinearColor& ColorAndOpacity) {
  21. 		this->Widget->SetBrush(Brush);
  22. 		this->Widget->SetColorAndOpacity(ColorAndOpacity);
  23. 	}
  24. };

WidgetButton.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Button.h"
  5. #include "Components/ButtonSlot.h"
  6. #include "WidgetContent.hpp"
  7.  
  8.  
  9. class WidgetButton : public WidgetContent<UButton> {
  10. public:
  11. 	WidgetButton(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  12.  
  13. 	~WidgetButton() {}
  14.  
  15. public:
  16. 	/**
  17. 	* 插槽(按键槽)
  18. 	*	@param {ChildWidget}						插槽中的Widget。
  19. 	*	@param {Padding}							填充 (左、 上、 右、 下)
  20. 	*	@param {HorizontalAlignment}				水平对齐
  21. 	*		EHorizontalAlignment::HAlign_Left			向左
  22. 	*		EHorizontalAlignment::HAlign_Center			居中
  23. 	*		EHorizontalAlignment::HAlign_Right			向右
  24. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  25. 	*	@param {VerticalAlignment}					垂直对齐
  26. 	*		EVerticalAlignment::VAlign_Top				向上
  27. 	*		EVerticalAlignment::VAlign_Center			居中
  28. 	*		EVerticalAlignment::VAlign_Bottom			向下
  29. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  30. 	*/
  31. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  32. 		UButtonSlot* Slot = Cast<UButtonSlot>(ChildWidget->Slot);
  33. 		Slot->SetPadding(Padding);
  34. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  35. 		Slot->SetVerticalAlignment(VerticalAlignment);
  36. 	}
  37.  
  38. 	/**
  39. 	* 外观
  40. 	*	@param {Style}					样式
  41. 	*	@param {ColorAndOpacity}		颜色和不透明度
  42. 	*	@param {BackgroundColor}		背景颜色
  43. 	*/
  44. 	void SetAppearance(const FButtonStyle& Style, const FLinearColor& ColorAndOpacity, const FLinearColor& BackgroundColor) {
  45. 		this->Widget->SetStyle(Style);
  46. 		this->Widget->SetColorAndOpacity(ColorAndOpacity);
  47. 		this->Widget->SetBackgroundColor(BackgroundColor);
  48. 	}
  49.  
  50. 	/**
  51. 	* 交互
  52. 	*	@param {IsFocusable}						为可聚焦
  53. 	*	@param {ClickMethod}						高级 - 点击方法
  54. 	*		EButtonClickMethod::Type::DownAndUp			上和下
  55. 	*		EButtonClickMethod::Type::MouseDown			鼠标下
  56. 	*		EButtonClickMethod::Type::MouseUp			鼠标上
  57. 	*		EButtonClickMethod::Type::PreciseClick		精准点击
  58. 	*	@param {TouchMethod}						高级 - 触控方法
  59. 	*		EButtonTouchMethod::Type::DownAndUp			上和下
  60. 	*		EButtonTouchMethod::Type::Down				下
  61. 	*		EButtonTouchMethod::Type::PreciseTap		精准点按
  62. 	*	@param {PressMethod}						高级 - 按压方法
  63. 	*		EButtonPressMethod::Type::DownAndUp			上和下
  64. 	*		EButtonPressMethod::Type::ButtonPress		按键按压
  65. 	*		EButtonPressMethod::Type::ButtonRelease		按键松开
  66. 	*/
  67. 	void SetMethod(bool IsFocusable, const EButtonClickMethod::Type& ClickMethod, const EButtonTouchMethod::Type& TouchMethod, const EButtonPressMethod::Type& PressMethod) {
  68. 		this->Widget->IsFocusable = IsFocusable;
  69. 		this->Widget->SetClickMethod(ClickMethod);
  70. 		this->Widget->SetTouchMethod(TouchMethod);
  71. 		this->Widget->SetPressMethod(PressMethod);
  72. 	}
  73. };

WidgetCheckBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/CheckBox.h"
  5. #include "WidgetContent.hpp"
  6.  
  7.  
  8. class WidgetCheckBox : public WidgetContent<UCheckBox> {
  9. public:
  10. 	WidgetCheckBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetCheckBox() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 外观
  17. 	*	@param {CheckedState}						已勾选状态
  18. 	*		ECheckBoxState::Unchecked					未勾选
  19. 	*		ECheckBoxState::Checked						已勾选
  20. 	*		ECheckBoxState::Undetermined				未确定
  21. 	*	@param {HorizontalAlignment}				水平对齐
  22. 	*		EHorizontalAlignment::HAlign_Left			向左
  23. 	*		EHorizontalAlignment::HAlign_Center			居中
  24. 	*		EHorizontalAlignment::HAlign_Right			向右
  25. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  26. 	*/
  27. 	void SetAppearance(const ECheckBoxState& CheckedState, const EHorizontalAlignment& HorizontalAlignment) {
  28. 		this->Widget->SetCheckedState(CheckedState);
  29. 		this->Widget->HorizontalAlignment = TEnumAsByte<EHorizontalAlignment>(HorizontalAlignment);
  30. 	}
  31.  
  32. 	/**
  33. 	* 样式
  34. 	*	@param {WidgetStyle}				样式
  35. 	*/
  36. 	void SetStyle(const FCheckBoxStyle& WidgetStyle) {
  37. 		this->Widget->WidgetStyle = WidgetStyle;
  38. 	}
  39.  
  40. 	/**
  41. 	* 交互
  42. 	*	@param {IsFocusable}						为可聚焦
  43. 	*	@param {ClickMethod}						高级 - 点击方法
  44. 	*		EButtonClickMethod::Type::DownAndUp			上和下
  45. 	*		EButtonClickMethod::Type::MouseDown			鼠标下
  46. 	*		EButtonClickMethod::Type::MouseUp			鼠标上
  47. 	*		EButtonClickMethod::Type::PreciseClick		精准点击
  48. 	*	@param {TouchMethod}						高级 - 触控方法
  49. 	*		EButtonTouchMethod::Type::DownAndUp			上和下
  50. 	*		EButtonTouchMethod::Type::Down				下
  51. 	*		EButtonTouchMethod::Type::PreciseTap		精准点按
  52. 	*	@param {PressMethod}						高级 - 按压方法
  53. 	*		EButtonPressMethod::Type::DownAndUp			上和下
  54. 	*		EButtonPressMethod::Type::ButtonPress		按键按压
  55. 	*		EButtonPressMethod::Type::ButtonRelease		按键松开
  56. 	*/
  57. 	void SetMethod(bool IsFocusable, const EButtonClickMethod::Type& ClickMethod, const EButtonTouchMethod::Type& TouchMethod, const EButtonPressMethod::Type& PressMethod) {
  58. 		this->Widget->IsFocusable = IsFocusable;
  59. 		this->Widget->SetClickMethod(ClickMethod);
  60. 		this->Widget->SetTouchMethod(TouchMethod);
  61. 		this->Widget->SetPressMethod(PressMethod);
  62. 	}
  63. };

WidgetBorder.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Border.h"
  5. #include "Components/BorderSlot.h"
  6. #include "WidgetContent.hpp"
  7.  
  8.  
  9. class WidgetBorder : public WidgetContent<UBorder> {
  10. public:
  11. 	WidgetBorder(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  12.  
  13. 	~WidgetBorder() {}
  14.  
  15. public:
  16. 	/**
  17. 	* 插槽(边界插槽)
  18. 	*	@param {ChildWidget}						插槽中的Widget。
  19. 	*	@param {Padding}							填充 (左、 上、 右、 下)
  20. 	*	@param {HorizontalAlignment}				水平对齐
  21. 	*		EHorizontalAlignment::HAlign_Left			向左
  22. 	*		EHorizontalAlignment::HAlign_Center			居中
  23. 	*		EHorizontalAlignment::HAlign_Right			向右
  24. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  25. 	*	@param {VerticalAlignment}					垂直对齐
  26. 	*		EVerticalAlignment::VAlign_Top				向上
  27. 	*		EVerticalAlignment::VAlign_Center			居中
  28. 	*		EVerticalAlignment::VAlign_Bottom			向下
  29. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  30. 	*/
  31. 	void SetSlot(UWidget* ChildWidget, const FMargin& Padding, const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment) {
  32. 		UBorderSlot* Slot = Cast<UBorderSlot>(ChildWidget->Slot);
  33. 		Slot->SetPadding(Padding);
  34. 		Slot->SetHorizontalAlignment(HorizontalAlignment);
  35. 		Slot->SetVerticalAlignment(VerticalAlignment);
  36. 	}
  37.  
  38. 	/**
  39. 	* 内容
  40. 	*	@param {HorizontalAlignment}				水平对齐
  41. 	*		EHorizontalAlignment::HAlign_Left			向左
  42. 	*		EHorizontalAlignment::HAlign_Center			居中
  43. 	*		EHorizontalAlignment::HAlign_Right			向右
  44. 	*		EHorizontalAlignment::HAlign_Fill			水平填充
  45. 	*	@param {VerticalAlignment}					垂直对齐
  46. 	*		EVerticalAlignment::VAlign_Top				向上
  47. 	*		EVerticalAlignment::VAlign_Center			居中
  48. 	*		EVerticalAlignment::VAlign_Bottom			向下
  49. 	*		EVerticalAlignment::VAlign_Fill				垂直填充
  50. 	*	@param {ContentColorAndOpacity}				内容颜色和不透明度
  51. 	*	@param {Padding}							填充（左、上、右、下）
  52. 	*/
  53. 	void SetAppearanceContent(const EHorizontalAlignment& HorizontalAlignment, const EVerticalAlignment& VerticalAlignment, const FLinearColor& ContentColorAndOpacity, const FMargin& Padding) {
  54. 		this->Widget->SetHorizontalAlignment(HorizontalAlignment);
  55. 		this->Widget->SetVerticalAlignment(VerticalAlignment);
  56. 		this->Widget->SetContentColorAndOpacity(ContentColorAndOpacity);
  57. 		this->Widget->SetPadding(Padding);
  58. 	}
  59.  
  60. 	/**
  61. 	* 外观
  62. 	*	@param {Brush}						笔刷
  63. 	*	@param {BrushColor}					笔刷颜色
  64. 	*	@param {Scale}						所需大小缩放
  65. 	*	@param {ShowEffectWhenDisabled}		高级 - 禁用时显示效果
  66. 	*/
  67. 	void SetAppearance(const FSlateBrush& Brush, const FLinearColor& BrushColor, const FVector2D& Scale, bool ShowEffectWhenDisabled) {
  68. 		this->Widget->SetBrush(Brush);
  69. 		this->Widget->SetBrushColor(BrushColor);
  70. 		this->Widget->SetDesiredSizeScale(Scale);
  71. 		this->Widget->bShowEffectWhenDisabled = ShowEffectWhenDisabled;
  72. 	}
  73. };

WidgetProgressBar.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/ProgressBar.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetProgressBar : public WidgetBase<UProgressBar> {
  9. public:
  10. 	WidgetProgressBar(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetProgressBar() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 样式
  17. 	*	@param {BackgroundImage}			背景图
  18. 	*	@param {FillImage}					填充图
  19. 	*	@param {MarqueeImage}				边框图
  20. 	*	@param {EnableFillAnimation}		启用填充动画
  21. 	*/
  22. 	void SetStyle(const FSlateBrush& BackgroundImage, const FSlateBrush& FillImage, const FSlateBrush& MarqueeImage, bool EnableFillAnimation) {
  23. 		FProgressBarStyle ProgressBarStyle;
  24. 		ProgressBarStyle.SetBackgroundImage(BackgroundImage);
  25. 		ProgressBarStyle.SetFillImage(FillImage);
  26. 		ProgressBarStyle.SetMarqueeImage(MarqueeImage);
  27. 		ProgressBarStyle.SetEnableFillAnimation(EnableFillAnimation);
  28. 		this->Widget->WidgetStyle = ProgressBarStyle;
  29. 	}
  30.  
  31. 	/**
  32. 	* 进度
  33. 	*	@param {Percent}											百分比
  34. 	*	@param {BarFillType}										条填充类型
  35. 	*		EProgressBarFillType::Type::LeftToRight						左到右
  36. 	*		EProgressBarFillType::Type::RightToLeft						右到左
  37. 	*		EProgressBarFillType::Type::FillFromCenter					从中心填充
  38. 	*		EProgressBarFillType::Type::FillFromCenterHorizontal		从中心水平填充
  39. 	*		EProgressBarFillType::Type::FillFromCenterVertical			从中心垂直填充
  40. 	*		EProgressBarFillType::Type::TopToBottom						顶到底
  41. 	*		EProgressBarFillType::Type::BottomToTop						底到顶
  42. 	*	@param {BarFillStyle}										条填充风格
  43. 	*		EProgressBarFillStyle::Type::Mask							遮罩
  44. 	*		EProgressBarFillStyle::Type::Scale							缩放
  45. 	*	@param {IsMarquee}											为边框
  46. 	*	@param {BorderPadding}										边缘填充
  47. 	*/
  48. 	void SetProgress(const float& Percent, const EProgressBarFillType::Type& BarFillType, const EProgressBarFillStyle::Type& BarFillStyle, bool IsMarquee, const FVector2D& BorderPadding) {
  49. 		this->Widget->SetPercent(Percent);
  50. 		this->Widget->BarFillType = BarFillType;
  51. 		this->Widget->BarFillStyle = BarFillStyle;
  52. 		this->Widget->SetIsMarquee(IsMarquee);
  53. 		this->Widget->BorderPadding = BorderPadding;
  54. 	}
  55.  
  56. 	/**
  57. 	* 外观
  58. 	*	@param {Color}			填充颜色和不透明度
  59. 	*/
  60. 	void SetAppearance(const FLinearColor& Color) {
  61. 		this->Widget->SetFillColorAndOpacity(Color);
  62. 	}
  63. };

WidgetSlider.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/Slider.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetSlider : public WidgetBase<USlider> {
  9. public:
  10. 	WidgetSlider(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetSlider() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 外观
  17. 	*	@param {Value}							值
  18. 	*	@param {MinValue}						最小值
  19. 	*	@param {MaxValue}						最大值
  20. 	*	@param {Orientation}					朝向
  21. 	*		EOrientation::Orient_Horizontal			水平
  22. 	*		EOrientation::Orient_Vertical			垂直
  23. 	*	@param {SliderBarColor}					滑条颜色
  24. 	*	@param {SliderHandleColor}				滑柄颜色
  25. 	*	@param {StepSize}						步大小
  26. 	*	@param {IsIndentHandle}					高级 - 缩进柄
  27. 	*	@param {IsLocked}						高级 - 锁定
  28. 	*	@param {MouseUsesStep}					高级 - 鼠标使用步
  29. 	*	@param {RequiresControllerLock}			高级 - 需要控制器锁定
  30. 	*/
  31. 	void SetAppearance(const float& Value, const float& MinValue, const float& MaxValue, const EOrientation& Orientation, const FLinearColor& SliderBarColor, const FLinearColor& SliderHandleColor, const float& StepSize, bool IsIndentHandle, bool IsLocked, bool MouseUsesStep, bool RequiresControllerLock) {
  32. 		this->Widget->SetValue(Value);
  33. 		this->Widget->SetMinValue(MinValue);
  34. 		this->Widget->SetMaxValue(MaxValue);
  35. 		this->Widget->Orientation = TEnumAsByte<EOrientation>(Orientation);
  36. 		this->Widget->SetSliderBarColor(SliderBarColor);
  37. 		this->Widget->SetSliderHandleColor(SliderHandleColor);
  38. 		this->Widget->SetStepSize(StepSize);
  39. 		this->Widget->SetIndentHandle(IsIndentHandle);
  40. 		this->Widget->SetLocked(IsLocked);
  41. 		this->Widget->MouseUsesStep = MouseUsesStep;
  42. 		this->Widget->RequiresControllerLock = RequiresControllerLock;
  43. 	}
  44.  
  45. 	/**
  46. 	* 样式
  47. 	*	@param {NormalBarImage}			样式 - 普通的条图像
  48. 	*	@param {HoveredBarImage}		样式 - 悬浮的条图像
  49. 	*	@param {DisabledBarImage}		样式 - 禁用的条图像
  50. 	*	@param {NormalThumbImage}		样式 - 普通的缩略图
  51. 	*	@param {HoveredThumbImage}		样式 - 悬浮的缩略图
  52. 	*	@param {DisabledThumbImage}		样式 - 禁用的缩略图
  53. 	*	@param {BarThickness}			条厚度
  54. 	*/
  55. 	void SetStyle(const FSlateBrush& NormalBarImage, const FSlateBrush& HoveredBarImage, const FSlateBrush& DisabledBarImage, const FSlateBrush& NormalThumbImage, const FSlateBrush& HoveredThumbImage, const FSlateBrush& DisabledThumbImage, const float& BarThickness) {
  56. 		FSliderStyle SliderStyle;
  57. 		SliderStyle.SetNormalBarImage(NormalBarImage);
  58. 		SliderStyle.SetHoveredBarImage(HoveredBarImage);
  59. 		SliderStyle.SetDisabledBarImage(DisabledBarImage);
  60. 		SliderStyle.SetNormalThumbImage(NormalThumbImage);
  61. 		SliderStyle.SetHoveredThumbImage(HoveredThumbImage);
  62. 		SliderStyle.SetDisabledThumbImage(DisabledThumbImage);
  63. 		SliderStyle.SetBarThickness(BarThickness);
  64. 		this->Widget->WidgetStyle = SliderStyle;
  65. 	}
  66.  
  67. 	/**
  68. 	* 交互
  69. 	*	@param {IsFocusable}			为可聚焦
  70. 	*/
  71. 	void SetInteraction(bool IsFocusable) {
  72. 		this->Widget->IsFocusable = IsFocusable;
  73. 	}
  74. };

3、输入类型组件

WidgetEditableText.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/EditableText.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetEditableText : public WidgetBase<UEditableText> {
  9. public:
  10. 	WidgetEditableText(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetEditableText() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 内容
  17. 	*	@param {Text}							文本
  18. 	*	@param {HintText}						提示文本
  19. 	*/
  20. 	void SetContent(const FString& Text, const FString& HintText) {
  21. 		this->Widget->SetText(FText::FromString(Text));
  22. 		this->Widget->SetHintText(FText::FromString(HintText));
  23. 	}
  24.  
  25. 	/**
  26. 	* 外观
  27. 	*	@param {Font}							字体
  28. 	*	@param {ColorAndOpacity}				颜色和不透明度
  29. 	*	@param {BackgroundImageSelected}		已选择背景图像
  30. 	*	@param {BackgroundImageComposing}		背景图像合成
  31. 	*	@param {CaretImage}						插入符图像
  32. 	*	@param {IsReadyOnly}					为只读
  33. 	*	@param {IsPassword}						为密码
  34. 	*	@param {MinimumDesiredWidth}			所需最小宽度
  35. 	*	@param {Justification}					对齐
  36. 	*		ETextJustify::Type::Left				将文本左对齐
  37. 	*		ETextJustify::Type::Center				将文本中对齐
  38. 	*		ETextJustify::Type::Right				将文本右对齐
  39. 	*/
  40. 	void SetAppearance(const FSlateFontInfo& Font, const FSlateColor& ColorAndOpacity, const FSlateBrush& BackgroundImageSelected, const FSlateBrush& BackgroundImageComposing, const FSlateBrush& CaretImage, bool IsReadyOnly, bool IsPassword, const float MinimumDesiredWidth, const ETextJustify::Type& Justification) {
  41. 		FEditableTextStyle EditableTextStyle;
  42. 		EditableTextStyle.SetFont(Font);
  43. 		EditableTextStyle.SetColorAndOpacity(ColorAndOpacity);
  44. 		EditableTextStyle.SetBackgroundImageSelected(BackgroundImageSelected);
  45. 		EditableTextStyle.SetBackgroundImageComposing(BackgroundImageComposing);
  46. 		EditableTextStyle.SetCaretImage(CaretImage);
  47. 		this->Widget->WidgetStyle = EditableTextStyle;
  48. 		this->Widget->SetIsReadOnly(IsReadyOnly);
  49. 		this->Widget->SetIsPassword(IsPassword);
  50. 		this->Widget->MinimumDesiredWidth = MinimumDesiredWidth;
  51. 		this->Widget->SetJustification(Justification);
  52. 	}
  53.  
  54. 	/**
  55. 	* 行为
  56. 	*	@param {IsCaretMovedWhenGainFocus}						高级 - 获取聚焦时插入符移动
  57. 	*	@param {SelectAllTextWhenFocused}						高级 - 聚焦时选择所有文本
  58. 	*	@param {RevertTextOnEscape}								高级 - 退出时恢复文本
  59. 	*	@param {ClearKeyboardFocusOnCommit}						高级 - 提交时清除键盘聚焦
  60. 	*	@param {SelectAllTextOnCommit}							高级 - 提交时选择所有文本
  61. 	*	@param {AllowContextMenu}								高级 - 允许快捷菜单
  62. 	*	@param {KeyboardType}									高级 - 键盘类型
  63. 	*		EVirtualKeyboardType::Type::Default						默认
  64. 	*		EVirtualKeyboardType::Type::Number						数字
  65. 	*		EVirtualKeyboardType::Type::Web							网络
  66. 	*		EVirtualKeyboardType::Type::Email						电子邮件
  67. 	*		EVirtualKeyboardType::Type::Password					密码
  68. 	*		EVirtualKeyboardType::Type::AlphaNumeric				透明度数字
  69. 	*	@param {EnableAutocorrect}								高级 - 虚拟键盘选项 - 启用自动修正
  70. 	*	@param {VirtualKeyboardTrigger}							高级 - 虚拟键盘触发器
  71. 	*		EVirtualKeyboardTrigger::OnFocusByPointer				在由指针的聚焦上
  72. 	*		EVirtualKeyboardTrigger::OnAllFocusEvents				在所有聚焦事件上
  73. 	*	@param {VirtualKeyboardDismissAction}					高级 - 虚拟键盘取消操作
  74. 	*		EVirtualKeyboardDismissAction::TextChangeOnDismiss		取消时变更文本
  75. 	*		EVirtualKeyboardDismissAction::TextCommitOnAccept		接受时提交文本
  76. 	*		EVirtualKeyboardDismissAction::TextCommitOnDismiss		取消时提交文本
  77. 	*/
  78. 	void SetBehavior(bool IsCaretMovedWhenGainFocus, bool SelectAllTextWhenFocused, bool RevertTextOnEscape, bool ClearKeyboardFocusOnCommit, bool SelectAllTextOnCommit, bool AllowContextMenu, const EVirtualKeyboardType::Type& KeyboardType, bool EnableAutocorrect, const EVirtualKeyboardTrigger& VirtualKeyboardTrigger, const EVirtualKeyboardDismissAction& VirtualKeyboardDismissAction) {
  79. 		this->Widget->IsCaretMovedWhenGainFocus = IsCaretMovedWhenGainFocus;
  80. 		this->Widget->SelectAllTextWhenFocused = SelectAllTextWhenFocused;
  81. 		this->Widget->RevertTextOnEscape = RevertTextOnEscape;
  82. 		this->Widget->ClearKeyboardFocusOnCommit = ClearKeyboardFocusOnCommit;
  83. 		this->Widget->SelectAllTextOnCommit = SelectAllTextOnCommit;
  84. 		this->Widget->AllowContextMenu = AllowContextMenu;
  85. 		this->Widget->SetKeyboardType(KeyboardType);
  86. 		FVirtualKeyboardOptions VirtualKeyboardOptions;
  87. 		VirtualKeyboardOptions.bEnableAutocorrect = EnableAutocorrect;
  88. 		this->Widget->VirtualKeyboardOptions = VirtualKeyboardOptions;
  89. 		this->Widget->VirtualKeyboardTrigger = VirtualKeyboardTrigger;
  90. 		this->Widget->VirtualKeyboardDismissAction = VirtualKeyboardDismissAction;
  91. 	}
  92.  
  93. 	/**
  94. 	* 裁剪
  95. 	*	@param {OverflowPolicy}				高级 - 溢出策略
  96. 	*		ETextOverflowPolicy::Clip			剪切
  97. 	*		ETextOverflowPolicy::Ellipsis		省略
  98. 	*/
  99. 	void SetClipping(const ETextOverflowPolicy& OverflowPolicy) {
  100. 		this->Widget->SetTextOverflowPolicy(OverflowPolicy);
  101. 	}
  102. };

WidgetEditableTextBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/EditableTextBox.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetEditableTextBox : public WidgetBase<UEditableTextBox> {
  9. public:
  10. 	WidgetEditableTextBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetEditableTextBox() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 内容
  17. 	*	@param {Text}							文本
  18. 	*	@param {HintText}						提示文本
  19. 	*/
  20. 	void SetContent(const FString& Text, const FString& HintText) {
  21. 		this->Widget->SetText(FText::FromString(Text));
  22. 		this->Widget->SetHintText(FText::FromString(HintText));
  23. 	}
  24.  
  25. 	/**
  26. 	* 外观
  27. 	*	@param {BackgroundImageNormal}			普通背景图像
  28. 	*	@param {BackgroundImageHovered}			已悬停背景图像
  29. 	*	@param {BackgroundImageFocused}			已聚焦背景图像
  30. 	*	@param {BackgroundImageReadOnly}		只读背景图像
  31. 	*	@param {Padding}						填充
  32. 	*	@param {Font}							文本风格
  33. 	*	@param {ForegroundColor}				前景颜色
  34. 	*	@param {BackgroundColor}				背景颜色
  35. 	*	@param {ReadOnlyForegroundColor}		只读前景颜色
  36. 	*	@param {FocusedForegroundColor}			聚焦前景颜色
  37. 	*	@param {HScrollBarPadding}				H滚动条填充
  38. 	*	@param {VScrollBarPadding}				V滚动条填充
  39. 	*	@param {ScrollBarStyle}					滚动条样式
  40. 	*	@param {IsReadyOnly}					为只读
  41. 	*	@param {IsPassword}						为密码
  42. 	*	@param {MinimumDesiredWidth}			所需最小宽度
  43. 	*	@param {Justification}					对齐
  44. 	*		ETextJustify::Type::Left				将文本左对齐
  45. 	*		ETextJustify::Type::Center				将文本中对齐
  46. 	*		ETextJustify::Type::Right				将文本右对齐
  47. 	*/
  48. 	void SetAppearance(const FSlateBrush& BackgroundImageNormal, const FSlateBrush& BackgroundImageHovered, const FSlateBrush& BackgroundImageFocused, const FSlateBrush& BackgroundImageReadOnly, const FMargin& Padding, const FSlateFontInfo& Font, const FSlateColor& ForegroundColor, const FSlateColor& BackgroundColor, const FSlateColor& ReadOnlyForegroundColor, const FSlateColor& FocusedForegroundColor, const FMargin& HScrollBarPadding, const FMargin& VScrollBarPadding, const FScrollBarStyle& ScrollBarStyle, bool IsReadyOnly, bool IsPassword, const float MinimumDesiredWidth, const ETextJustify::Type& Justification) {
  49. 		FEditableTextBoxStyle EditableTextBoxStyle;
  50. 		EditableTextBoxStyle.SetBackgroundImageNormal(BackgroundImageNormal);
  51. 		EditableTextBoxStyle.SetBackgroundImageHovered(BackgroundImageHovered);
  52. 		EditableTextBoxStyle.SetBackgroundImageFocused(BackgroundImageFocused);
  53. 		EditableTextBoxStyle.SetBackgroundImageReadOnly(BackgroundImageReadOnly);
  54. 		EditableTextBoxStyle.SetPadding(Padding);
  55. 		EditableTextBoxStyle.SetFont(Font);
  56. 		EditableTextBoxStyle.SetForegroundColor(ForegroundColor);
  57. 		EditableTextBoxStyle.SetBackgroundColor(BackgroundColor);
  58. 		EditableTextBoxStyle.SetReadOnlyForegroundColor(ReadOnlyForegroundColor);
  59. 		EditableTextBoxStyle.SetFocusedForegroundColor(FocusedForegroundColor);
  60. 		EditableTextBoxStyle.SetHScrollBarPadding(HScrollBarPadding);
  61. 		EditableTextBoxStyle.SetVScrollBarPadding(VScrollBarPadding);
  62. 		EditableTextBoxStyle.SetScrollBarStyle(ScrollBarStyle);
  63. 		this->Widget->WidgetStyle = EditableTextBoxStyle;
  64. 		this->Widget->SetIsReadOnly(IsReadyOnly);
  65. 		this->Widget->SetIsPassword(IsPassword);
  66. 		this->Widget->MinimumDesiredWidth = MinimumDesiredWidth;
  67. 		this->Widget->SetJustification(Justification);
  68. 	}
  69.  
  70. 	/**
  71. 	* 行为
  72. 	*	@param {IsCaretMovedWhenGainFocus}						高级 - 获取聚焦时插入符移动
  73. 	*	@param {SelectAllTextWhenFocused}						高级 - 聚焦时选择所有文本
  74. 	*	@param {RevertTextOnEscape}								高级 - 退出时恢复文本
  75. 	*	@param {ClearKeyboardFocusOnCommit}						高级 - 提交时清除键盘聚焦
  76. 	*	@param {SelectAllTextOnCommit}							高级 - 提交时选择所有文本
  77. 	*	@param {AllowContextMenu}								高级 - 允许快捷菜单
  78. 	*	@param {KeyboardType}									高级 - 键盘类型
  79. 	*		EVirtualKeyboardType::Type::Default						默认
  80. 	*		EVirtualKeyboardType::Type::Number						数字
  81. 	*		EVirtualKeyboardType::Type::Web							网络
  82. 	*		EVirtualKeyboardType::Type::Email						电子邮件
  83. 	*		EVirtualKeyboardType::Type::Password					密码
  84. 	*		EVirtualKeyboardType::Type::AlphaNumeric				透明度数字
  85. 	*	@param {EnableAutocorrect}								高级 - 虚拟键盘选项 - 启用自动修正
  86. 	*	@param {VirtualKeyboardTrigger}							高级 - 虚拟键盘触发器
  87. 	*		EVirtualKeyboardTrigger::OnFocusByPointer				在由指针的聚焦上
  88. 	*		EVirtualKeyboardTrigger::OnAllFocusEvents				在所有聚焦事件上
  89. 	*	@param {VirtualKeyboardDismissAction}					高级 - 虚拟键盘取消操作
  90. 	*		EVirtualKeyboardDismissAction::TextChangeOnDismiss		取消时变更文本
  91. 	*		EVirtualKeyboardDismissAction::TextCommitOnAccept		接受时提交文本
  92. 	*		EVirtualKeyboardDismissAction::TextCommitOnDismiss		取消时提交文本
  93. 	*/
  94. 	void SetBehavior(bool IsCaretMovedWhenGainFocus, bool SelectAllTextWhenFocused, bool RevertTextOnEscape, bool ClearKeyboardFocusOnCommit, bool SelectAllTextOnCommit, bool AllowContextMenu, const EVirtualKeyboardType::Type& KeyboardType, bool EnableAutocorrect, const EVirtualKeyboardTrigger& VirtualKeyboardTrigger, const EVirtualKeyboardDismissAction& VirtualKeyboardDismissAction) {
  95. 		this->Widget->IsCaretMovedWhenGainFocus = IsCaretMovedWhenGainFocus;
  96. 		this->Widget->SelectAllTextWhenFocused = SelectAllTextWhenFocused;
  97. 		this->Widget->RevertTextOnEscape = RevertTextOnEscape;
  98. 		this->Widget->ClearKeyboardFocusOnCommit = ClearKeyboardFocusOnCommit;
  99. 		this->Widget->SelectAllTextOnCommit = SelectAllTextOnCommit;
  100. 		this->Widget->AllowContextMenu = AllowContextMenu;
  101. 		this->Widget->KeyboardType = TEnumAsByte<EVirtualKeyboardType::Type>(KeyboardType);
  102. 		FVirtualKeyboardOptions VirtualKeyboardOptions;
  103. 		VirtualKeyboardOptions.bEnableAutocorrect = EnableAutocorrect;
  104. 		this->Widget->VirtualKeyboardOptions = VirtualKeyboardOptions;
  105. 		this->Widget->VirtualKeyboardTrigger = VirtualKeyboardTrigger;
  106. 		this->Widget->VirtualKeyboardDismissAction = VirtualKeyboardDismissAction;
  107. 	}
  108.  
  109. 	/**
  110. 	* 裁剪
  111. 	*	@param {OverflowPolicy}				高级 - 溢出策略
  112. 	*		ETextOverflowPolicy::Clip			剪切
  113. 	*		ETextOverflowPolicy::Ellipsis		省略
  114. 	*/
  115. 	void SetClipping(const ETextOverflowPolicy& OverflowPolicy) {
  116. 		this->Widget->SetTextOverflowPolicy(OverflowPolicy);
  117. 	}
  118. };

4、列表类型

WidgetListView.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/ListView.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. template <typename WidgetT = UListView>
  9. class WidgetListView : public WidgetBase<WidgetT> {
  10. public:
  11. 	WidgetListView(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint, WidgetName) {}
  12.  
  13. 	~WidgetListView() {}
  14.  
  15. public:
  16. 	/**
  17. 	* 滚动中
  18. 	*	@param {ScrollbarVisibility}						显示滚动条（* 运行时才有效）
  19. 	*		ESlateVisibility::Visible							(可视)
  20. 	*		ESlateVisibility::Collapsed							(已折叠)
  21. 	*		ESlateVisibility::Hidden							(隐藏)
  22. 	*		ESlateVisibility::HitTestInvisible					(非可命中测试(自身和所有子项))
  23. 	*		ESlateVisibility::SelfHitTestInvisible				(非可命中测试(仅自身))
  24. 	*	@param {WheelScrollMultiplier}						滚轮滚动乘数
  25. 	*	@param {ScrollOffset}								固定行滚动偏移（* 运行时才有效）
  26. 	*/
  27. 	void SetScrolling(const ESlateVisibility& ScrollbarVisibility, const float& WheelScrollMultiplier, const float& ScrollOffset) {
  28. 		this->Widget->SetScrollbarVisibility(ScrollbarVisibility);
  29. 		this->Widget->SetWheelScrollMultiplier(WheelScrollMultiplier);
  30. 		this->Widget->SetScrollOffset(ScrollOffset);
  31. 	}
  32.  
  33. 	/**
  34. 	* 列表视图
  35. 	*	@param {SelectionMode}							选择模式
  36. 	*		ESelectionMode::Type::None						无
  37. 	*		ESelectionMode::Type::Single					单个
  38. 	*		ESelectionMode::Type::SingleToggle				单个切换
  39. 	*		ESelectionMode::Type::Multi						多个
  40. 	*/
  41. 	void SetListView(const ESelectionMode::Type& SelectionMode) {
  42. 		this->Widget->SetSelectionMode(TEnumAsByte<ESelectionMode::Type>(SelectionMode));
  43. 	}
  44.  
  45. 	/**
  46. 	* 列表记录
  47. 	*	@param {EntryWidgetClass}						条目控件类
  48. 	*/
  49. 	void SetEntryWidgetClass(const TSubclassOf<UUserWidget>& EntryWidgetClass) {
  50. 		const UClass* WidgetClass = this->Widget->GetClass();
  51. 		const FProperty* Property = WidgetClass->FindPropertyByName(FName(TEXT("EntryWidgetClass")));
  52. 		if (Property) {
  53. 			TSubclassOf<UUserWidget>* ValuePtr = Property->ContainerPtrToValuePtr<TSubclassOf<UUserWidget>>(this->Widget);
  54. 			Property->CopySingleValue(ValuePtr, &EntryWidgetClass);
  55. 		}
  56. 	}
  57.  
  58. 	/**	
  59. 	* 列表记录
  60. 	*	@param {EntryWidgetBlueprint}					条目控件蓝图
  61. 	*/
  62. 	void SetEntryWidgetClass(UWidgetBlueprint* EntryWidgetBlueprint) {
  63. 		const TSubclassOf<UUserWidget> EntryWidgetClass = EntryWidgetBlueprint->GeneratedClass;
  64. 		this->SetEntryWidgetClass(EntryWidgetClass);
  65. 	}
  66. };

WidgetTileView.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/TileView.h"
  5. #include "WidgetListView.hpp"
  6.  
  7.  
  8. class WidgetTileView : public WidgetListView<UTileView> {
  9. public:
  10. 	WidgetTileView(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetListView(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetTileView() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 列表记录
  17. 	*	@param {EntryHeight}						条目高度
  18. 	*	@param {EntryWidth}							条目宽度
  19. 	*/
  20. 	void SetListEntries(const float& EntryHeight, const float& EntryWidth) {
  21. 		this->Widget->SetEntryHeight(EntryHeight);
  22. 		this->Widget->SetEntryWidth(EntryWidth);
  23. 	}
  24. };

5、优化

WidgetRetainerBox.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Components/RetainerBox.h"
  5. #include "WidgetContent.hpp"
  6.  
  7.  
  8. class WidgetRetainerBox : public WidgetContent<URetainerBox> {
  9. public:
  10. 	WidgetRetainerBox(UWidgetBlueprint* WidgetBlueprint, FName& WidgetName) : WidgetContent(WidgetBlueprint, WidgetName) {}
  11.  
  12. 	~WidgetRetainerBox() {}
  13.  
  14. public:
  15. 	/**
  16. 	* 渲染规则
  17. 	*	@param {RetainRendering}			保留渲染。
  18. 	*	@param {RenderOnInvalidation}		失效时渲染
  19. 	*	@param {RenderOnPhase}				相位时渲染
  20. 	*	@param {RenderPhase}				相位
  21. 	*	@param {TotalPhases}				相位数
  22. 	*/
  23. 	void SetRendering(bool RetainRendering, bool RenderOnInvalidation, bool RenderOnPhase, const int32& RenderPhase, const int32& TotalPhases) {
  24. 		this->Widget->SetRetainRendering(RetainRendering);
  25. 		this->Widget->RenderOnInvalidation = RenderOnInvalidation;
  26. 		this->Widget->RenderOnPhase = RenderOnPhase;
  27. 		this->Widget->SetRenderingPhase(RenderPhase, TotalPhases);
  28. 	}
  29.  
  30. 	/**
  31. 	* 效果
  32. 	*	@param {EffectMaterial}			效果材质。
  33. 	*	@param {TextureParameter}		纹理参数
  34. 	*/
  35. 	void SetEffect(UMaterialInterface* EffectMaterial, const FName& TextureParameter) {
  36. 		this->Widget->SetEffectMaterial(EffectMaterial);
  37. 		this->Widget->SetTextureParameter(TextureParameter);
  38. 	}
  39.  
  40. 	/**
  41. 	* 效果
  42. 	*	@param {EffectMaterialPath}		效果材质路径。
  43. 	*	@param {TextureParameter}		纹理参数
  44. 	*/
  45. 	void SetEffect(const FString& EffectMaterialPath, const FName& TextureParameter) {
  46. 		UMaterialInterface* EffectMaterial = Cast<UMaterialInterface>(StaticLoadObject(UMaterialInterface::StaticClass(), nullptr, *EffectMaterialPath));
  47. 		if (EffectMaterial) {
  48. 			this->SetEffect(EffectMaterial, TextureParameter);
  49. 		}
  50. 	}
  51. };

6、用户创建

WidgetUserWidget.hpp 文件

  1. #pragma once
  2.  
  3. #include "WidgetBlueprint.h"
  4. #include "Blueprint/UserWidget.h"
  5. #include "WidgetBase.hpp"
  6.  
  7.  
  8. class WidgetUserWidget : public WidgetBase<UUserWidget> {
  9. public:
  10. 	UWidgetBlueprint* UserWidgetBlueprint;
  11.  
  12. public:
  13. 	WidgetUserWidget(UWidgetBlueprint* WidgetBlueprint, UWidgetBlueprint* UserWidgetBlueprint, FName& WidgetName) : WidgetBase(WidgetBlueprint), UserWidgetBlueprint(UserWidgetBlueprint) {
  14. 		UClass* UserWidgetClass = UserWidgetBlueprint->GeneratedClass;
  15. 		if (UserWidgetClass && UserWidgetClass->IsChildOf(UUserWidget::StaticClass())) {
  16. 			this->Widget = WidgetBlueprint->WidgetTree->ConstructWidget<UUserWidget>(UserWidgetClass, WidgetName);
  17. 		}
  18. 	}
  19.  
  20. 	~WidgetUserWidget() {}
  21.  
  22. public:
  23. 	// 外观 - 颜色和不透明度
  24. 	void SetColorAndOpacity(const FLinearColor& ColorAndOpacity) {
  25. 		this->Widget->SetColorAndOpacity(ColorAndOpacity);
  26. 	}
  27.  
  28. 	// 外观 - 前景颜色
  29. 	void SetForegroundColor(const FSlateColor& ForegroundColor) {
  30. 		this->Widget->SetForegroundColor(ForegroundColor);
  31. 	}
  32.  
  33. 	// 外观 - 填充
  34. 	void SetPadding(const FMargin& Padding) {
  35. 		this->Widget->SetPadding(Padding);
  36. 	}
  37. };

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/IT小白/article/detail/107114
推荐阅读

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。