第一次提交

Plugins/GGS/Source/GenericUISystem/Public/UI/Common/GUIS_UserWidgetInterface.h

@@ -0,0 +1,63 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "UObject/Interface.h"
+#include "GUIS_UserWidgetInterface.generated.h"
+
+/**
+ * Interface for UserWidget functionality.
+ * 通用UserWidget功能的接口。
+ * @note Designed for UserWidgets (except UCommonActivatableWidget and its derivatives).
+ * @注意 专为UserWidget设计（不包括UCommonActivatableWidget及其派生类）。
+ * @details Automatically called when used as an extension UI.
+ * @细节 用作扩展UI时自动调用。
+ */
+UINTERFACE()
+class GENERICUISYSTEM_API UGUIS_UserWidgetInterface : public UInterface
+{
+	GENERATED_BODY()
+};
+
+/**
+ * Implementation class for UserWidget interface.
+ * UserWidget接口的实现类。
+ */
+class GENERICUISYSTEM_API IGUIS_UserWidgetInterface
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Retrieves the owning actor of the UserWidget.
+	 * 获取UserWidget的所属演员。
+	 * @return The logical owning actor. 逻辑所属演员。
+	 * @note Tracks data for an actor in the game world.
+	 * @注意 跟踪游戏世界中演员的数据。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GUIS")
+	AActor* GetOwningActor();
+
+	/**
+	 * Sets the owning actor of the UserWidget.
+	 * 设置UserWidget的所属演员。
+	 * @param NewOwningActor The new owning actor. 新的所属演员。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GUIS")
+	void SetOwningActor(AActor* NewOwningActor);
+
+	/**
+	 * Called when the UserWidget is activated.
+	 * UserWidget激活时调用。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GUIS")
+	void OnActivated();
+
+	/**
+	 * Called when the UserWidget is deactivated.
+	 * UserWidget禁用时调用。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GUIS")
+	void OnDeactivated();
+};