第一次提交

Plugins/GGS/Source/GenericUISystem/Public/UI/Modal/GUIS_GameModal.h

@@ -0,0 +1,129 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CommonActivatableWidget.h"
+#include "GameplayTagContainer.h"
+#include "GUIS_GameModalTypes.h"
+#include "GUIS_GameModal.generated.h"
+
+class UCommonTextBlock;
+class UDynamicEntryBox;
+class UGUIS_GameModalWidget;
+
+/**
+ * Definition for a modal dialog.
+ * 模态对话框的定义。
+ */
+UCLASS(Abstract, BlueprintType, Blueprintable, Const)
+class GENERICUISYSTEM_API UGUIS_ModalDefinition : public UObject
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Header text for the modal.
+	 * 模态对话框的标题文本。
+	 */
+	UPROPERTY(EditAnywhere, Category="GUIS", BlueprintReadWrite)
+	FText Header;
+
+	/**
+	 * Body text for the modal.
+	 * 模态对话框的正文文本。
+	 */
+	UPROPERTY(EditAnywhere, Category="GUIS", BlueprintReadWrite)
+	FText Body;
+
+	/**
+	 * Widget class used to represent the modal.
+	 * 表示模态对话框的小部件类。
+	 */
+	UPROPERTY(EditAnywhere, Category="GUIS", BlueprintReadWrite)
+	TSoftClassPtr<UGUIS_GameModalWidget> ModalWidget;
+
+	/**
+	 * Map of modal actions to their configurations.
+	 * 模态动作及其配置的映射。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GUIS", meta = (ForceInlineRow, Categories = "GUIS.Modal.Action"))
+	TMap<FGameplayTag, FGUIS_GameModalAction> ModalActions;
+};
+
+/**
+ * Base widget for modal dialogs.
+ * 模态对话框的基础小部件。
+ * @note Must bind a DynamicEntryBox named "EntryBox_Buttons" for button registration.
+ * @注意 必须绑定一个名为"EntryBox_Buttons"的DynamicEntryBox以注册按钮。
+ */
+UCLASS(Abstract, meta = (Category = "Generic UI"))
+class GENERICUISYSTEM_API UGUIS_GameModalWidget : public UCommonActivatableWidget
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Constructor for the modal widget.
+	 * 模态小部件构造函数。
+	 */
+	UGUIS_GameModalWidget();
+
+	/**
+	 * Sets up the modal with the provided definition.
+	 * 使用提供的定义设置模态对话框。
+	 * @param ModalDefinition The modal definition. 模态定义。
+	 * @param ModalActionCallback Callback for modal actions. 模态动作回调。
+	 */
+	virtual void SetupModal(const UGUIS_ModalDefinition* ModalDefinition, FGUIS_ModalActionResultSignature ModalActionCallback);
+
+	/**
+	 * Closes the modal with the specified result.
+	 * 以指定结果关闭模态对话框。
+	 * @param ModalActionResult The modal action result. 模态动作结果。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GUIS", meta = (Categories = "UI.Modal.Action,GUIS.Modal.Action"))
+	void CloseModal(FGameplayTag ModalActionResult);
+
+	/**
+	 * Terminates the modal.
+	 * 终止模态对话框。
+	 */
+	virtual void KillModal();
+
+protected:
+	/**
+	 * Event to apply modal definition data to UI elements.
+	 * 将模态定义数据应用于UI元素的事件。
+	 * @param ModalDefinition The modal definition. 模态定义。
+	 */
+	UFUNCTION(BlueprintImplementableEvent, Category="GUIS")
+	void OnSetupModal(const UGUIS_ModalDefinition* ModalDefinition);
+
+	/**
+	 * Callback for modal action results.
+	 * 模态动作结果的回调。
+	 */
+	FGUIS_ModalActionResultSignature OnModalActionCallback;
+
+private:
+	/**
+	 * Dynamic entry box for modal buttons.
+	 * 模态按钮的动态入口框。
+	 */
+	UPROPERTY(Meta = (BindWidget))
+	TObjectPtr<UDynamicEntryBox> EntryBox_Buttons;
+
+	/**
+	 * Text block for the modal header.
+	 * 模态标题的文本块。
+	 */
+	UPROPERTY(Meta = (BindWidget))
+	TObjectPtr<UCommonTextBlock> Text_Header;
+
+	/**
+	 * Text block for the modal body.
+	 * 模态正文的文本块。
+	 */
+	UPROPERTY(Meta = (BindWidget))
+	TObjectPtr<UCommonTextBlock> Text_Body;
+};

Plugins/GGS/Source/GenericUISystem/Public/UI/Modal/GUIS_GameModalTypes.h

@@ -0,0 +1,50 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "GameplayTagContainer.h"
+#include "Subsystems/LocalPlayerSubsystem.h"
+#include "Engine/DataTable.h"
+#include "GUIS_GameModalTypes.generated.h"
+
+class UGUIS_ButtonBase;
+class FSubsystemCollectionBase;
+class UGUIS_ModalDefinition;
+class UObject;
+
+/**
+ * Delegate for modal action results.
+ * 模态动作结果的委托。
+ */
+DECLARE_DELEGATE_OneParam(FGUIS_ModalActionResultSignature, FGameplayTag /* Result */);
+
+/**
+ * Configuration for a modal action.
+ * 模态动作的配置。
+ */
+USTRUCT(BlueprintType)
+struct GENERICUISYSTEM_API FGUIS_GameModalAction
+{
+	GENERATED_BODY()
+
+	/**
+		 * Display text for the modal action.
+		 * 模态动作的显示文本。
+		 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GUIS")
+	FText DisplayText;
+
+	/**
+	 * Button widget class for the modal action.
+	 * 模态动作的按钮小部件类。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GUIS", NoClear)
+	TSoftClassPtr<UGUIS_ButtonBase> ButtonType;
+
+	/**
+	 * Input action associated with the modal action.
+	 * 模态动作关联的输入动作。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GUIS", meta = (RowType = "/Script/CommonUI.CommonInputActionDataBase"))
+	FDataTableRowHandle InputAction;
+};