initial commit

client/gui/props/BackgroundPropertySection.h

@@ -0,0 +1,32 @@
+#pragma once
+
+#include "props/PropertySectionWidget.h"
+
+class QLabel;
+class QCheckBox;
+
+namespace gui {
+
+// 背景相关属性：尺寸、显隐、深度叠加（可嵌入 QStackedWidget 的一页）
+class BackgroundPropertySection final : public PropertySectionWidget {
+    Q_OBJECT
+public:
+    explicit BackgroundPropertySection(QWidget* parent = nullptr);
+
+    void setBackgroundSizeText(const QString& text);
+    void syncBackgroundVisible(bool visible, bool controlsEnabled);
+    void syncDepthOverlayChecked(bool on);
+    void setDepthOverlayCheckEnabled(bool on);
+    void setProjectClosedAppearance();
+
+signals:
+    void backgroundVisibleToggled(bool on);
+    void depthOverlayToggled(bool on);
+
+private:
+    QLabel* m_sizeLabel = nullptr;
+    QCheckBox* m_showBackground = nullptr;
+    QCheckBox* m_depthOverlay = nullptr;
+};
+
+}  // namespace gui