DtkDeclarative
DTK Declarative module
载入中...
搜索中...
未找到
dqmlglobalobject_p.h
1// SPDX-FileCopyrightText: 2020 - 2026 UnionTech Software Technology Co., Ltd.
2//
3// SPDX-License-Identifier: LGPL-3.0-or-later
4
5#ifndef DQMLGLOBALOBJECT_P_H
6#define DQMLGLOBALOBJECT_P_H
7
8#include <dtkdeclarative_global.h>
9
10#include <DPlatformThemeProxy>
11#include <DWindowManagerHelper>
12#include <DGuiApplicationHelper>
13#include <DDciIconPalette>
14#include <DObject>
15
16#include <QQuickWindow>
17#include <QQmlComponent>
18#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
19#include <QPainter>
20#endif
21
22#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
23QT_BEGIN_NAMESPACE
24class QQuickPalette;
25QT_END_NAMESPACE
26#endif
27
28DGUI_BEGIN_NAMESPACE
29class DFontManager;
30DGUI_END_NAMESPACE
31
32DGUI_USE_NAMESPACE
33
34DQUICK_BEGIN_NAMESPACE
35
36class DColor
37{
38 Q_GADGET
39#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
40 QML_VALUE_TYPE(dcolor)
41#endif
42public:
43 enum Type : quint8 {
44 Invalid = 0,
45 Highlight,
46 HighlightedText
47 };
48 Q_ENUM(Type)
49
50 DColor() {}
51 inline DColor(const QColor &color) {
52 data.color.value = color;
53 }
54#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
55 DColor(const QJSValue &params) : DColor(QColor(params.toString())) { }
56#endif
57 DColor(Type type);
58 inline DColor(const DColor &other) {
59 memcpy(static_cast<void*>(&data), static_cast<const void*>(&other.data), sizeof(Data));
60 }
61 inline DColor(DColor &&other) {
62 operator =(other);
63 }
64
65 [[nodiscard]] bool isValid() const noexcept;
66 [[nodiscard]] bool isTypedColor() const noexcept;
67 [[nodiscard]] quint8 type() const noexcept;
68
69 bool operator==(const DColor &c) const noexcept;
70 bool operator!=(const DColor &c) const noexcept;
71 inline DColor &operator=(const QColor &color) {
72 data.color.value = color;
73 return *this;
74 }
75 inline DColor &operator=(const DColor &other) {
76 memcpy(static_cast<void*>(&data), static_cast<const void*>(&other.data), sizeof(Data));
77 return *this;
78 }
79 inline DColor &operator=(DColor &&other) {
80 data.hue = std::move(other.data.hue);
81 data.saturation = std::move(other.data.saturation);
82 data.lightness = std::move(other.data.lightness);
83 data.opacity = std::move(other.data.opacity);
84 data.color.value = std::move(other.data.color.value);
85 return *this;
86 }
87
88 Q_INVOKABLE QColor toColor(const QPalette &palette) const;
89 Q_INVOKABLE QColor color() const;
90 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor hue(qint8 floatValue) const;
91 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor saturation(qint8 floatValue) const;
92 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor lightness(qint8 floatValue) const;
93 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor opacity(qint8 floatValue) const;
94
95private:
96 struct Data {
97 qint8 hue = 0;
98 qint8 saturation = 0;
99 qint8 lightness = 0;
100 qint8 opacity = 0;
101
102 union Color {
103 #ifdef Q_COMPILER_UNIFORM_INIT
104 Color() {} // doesn't init anything, thus can't be constexpr
105 #endif
106 quint8 type; // DQMLGlobalObject::TypedColor
107 QColor value = QColor();
108 } color;
109 } data;
110};
111
112class DQuickDciIcon;
113class FloatingMessageContainer;
114class DQMLGlobalObjectPrivate;
115class DQMLGlobalObject : public QObject, public DTK_CORE_NAMESPACE::DObject
116{
117 Q_OBJECT
118
119 Q_PROPERTY(bool hasBlurWindow READ hasBlurWindow NOTIFY hasBlurWindowChanged)
120 Q_PROPERTY(bool hasComposite READ hasComposite NOTIFY hasCompositeChanged)
121 Q_PROPERTY(bool hasNoTitlebar READ hasNoTitlebar NOTIFY hasNoTitlebarChanged)
122 Q_PROPERTY(bool hasAnimation READ hasAnimation NOTIFY hasAnimationChanged)
123 Q_PROPERTY(bool hasInWindowBlur READ hasInWindowBlur NOTIFY hasInWindowBlurChanged)
124 Q_PROPERTY(bool isSoftwareRender READ isSoftwareRender FINAL CONSTANT)
125 Q_PROPERTY(DTK_GUI_NAMESPACE::DWindowManagerHelper::WMName windowManagerName READ windowManagerName CONSTANT)
126 Q_PROPERTY(DTK_GUI_NAMESPACE::DGuiApplicationHelper::ColorType themeType READ themeType NOTIFY themeTypeChanged)
127 Q_PROPERTY(QString windowManagerNameString READ windowManagerNameString CONSTANT)
128 Q_PROPERTY(DPlatformThemeProxy *platformTheme READ platformTheme FINAL CONSTANT)
129 Q_PROPERTY(DTK_GUI_NAMESPACE::DFontManager *fontManager READ fontManager FINAL CONSTANT)
130#if QT_VERSION <= QT_VERSION_CHECK(6, 0, 0)
131 Q_PROPERTY(QPalette palette READ palette NOTIFY paletteChanged)
132 Q_PROPERTY(QPalette inactivePalette READ inactivePalette NOTIFY inactivePaletteChanged)
133#else
134 Q_PROPERTY(QQuickPalette* palette READ quickPalette NOTIFY paletteChanged)
135 Q_PROPERTY(QQuickPalette* inactivePalette READ inactiveQuickPalette NOTIFY inactivePaletteChanged)
136#endif
137 Q_PROPERTY(QString deepinDistributionOrgLogo READ deepinDistributionOrgLogo CONSTANT)
138 Q_PROPERTY(QString deepinWebsiteName READ deepinWebsiteName CONSTANT)
139 Q_PROPERTY(QString deepinWebsiteLink READ deepinWebsiteLink CONSTANT)
140#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
141 QML_NAMED_ELEMENT(DTK)
142 QML_SINGLETON
143#endif
144
145public:
146 explicit DQMLGlobalObject(QObject *parent = nullptr);
147 ~DQMLGlobalObject() override;
148
149 static DQMLGlobalObject *create(QQmlEngine *qmlEngine, QJSEngine *jsEngine)
150 {
151 Q_UNUSED(qmlEngine)
152 Q_UNUSED(jsEngine)
153 return new DQMLGlobalObject;
154 }
155
156 enum ControlState {
157 NormalState,
158 HoveredState,
159 PressedState,
160 DisabledState,
161 InactiveState
162 };
163 Q_ENUM(ControlState)
164
165 enum ZOrder {
166 BottomOrder = -99,
167 BelowOrder = -1,
168 NormalOrder = 0,
169 AboveOrder = 1,
170 TopOrder = 99
171 };
172 Q_ENUM(ZOrder)
173
174#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
175 enum class CompositionMode {
176 Source = QPainter::CompositionMode_Source,
177 SourceOver = QPainter::CompositionMode_SourceOver,
178 Destination = QPainter::CompositionMode_Destination,
179 DestinationOver = QPainter::CompositionMode_DestinationOver,
180 Clear = QPainter::CompositionMode_Clear,
181 };
182 Q_ENUM(CompositionMode)
183#endif
184
185 bool hasBlurWindow() const;
186 bool hasComposite() const;
187 bool hasNoTitlebar() const;
188 static bool hasAnimation();
189 static bool hasInWindowBlur();
190 static bool isSoftwareRender();
191
192 DWindowManagerHelper::WMName windowManagerName() const;
193 QString windowManagerNameString() const;
194
195 DGuiApplicationHelper::ColorType themeType() const;
196
197 DPlatformThemeProxy *platformTheme() const;
198 DFontManager *fontManager() const;
199
200 QPalette palette() const;
201 QPalette inactivePalette() const;
202#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
203 QQuickPalette *quickPalette() const;
204 QQuickPalette *inactiveQuickPalette() const;
205#endif
206
207 Q_INVOKABLE QColor blendColor(const QColor &substrate, const QColor &superstratum);
208 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor makeColor(DTK_QUICK_NAMESPACE::DColor::Type type);
209 Q_INVOKABLE DTK_QUICK_NAMESPACE::DColor makeColor(const QColor &color);
210 Q_INVOKABLE QUrl makeShadowImageUrl(qreal boxSize, qreal cornerRadius, qreal shadowBlur,
211 QColor color, qreal xOffset, qreal yOffset, qreal spread,
212 bool hollow, bool inner);
213 Q_INVOKABLE QUrl makeShadowImageUrl(qreal boxSize, qreal topLeftRadius, qreal topRightRadius, qreal bottomLeftRadius, qreal bottomRightRadius,
214 qreal shadowBlur, QColor color, qreal xOffset, qreal yOffset, qreal spread,
215 bool hollow, bool inner);
216
217 Q_INVOKABLE DTK_GUI_NAMESPACE::DGuiApplicationHelper::ColorType toColorType(const QColor &color);
218 Q_INVOKABLE QColor selectColor(const QColor &windowColor, const QColor &light, const QColor &dark);
219
220 QString deepinWebsiteName() const;
221 QString deepinWebsiteLink() const;
222 QString deepinDistributionOrgLogo() const;
223
224 Q_INVOKABLE QPoint cursorPosition() const;
225
226 Q_INVOKABLE DTK_QUICK_NAMESPACE::DQuickDciIcon makeIcon(const QJSValue &qicon, const QJSValue &iconExtra);
227#if QT_VERSION <= QT_VERSION_CHECK(6, 0, 0)
228 Q_INVOKABLE DTK_GUI_NAMESPACE::DDciIconPalette makeIconPalette(const QPalette &palette);
229#else
230 Q_INVOKABLE DTK_GUI_NAMESPACE::DDciIconPalette makeIconPalette(const QQuickPalette *palette);
231#endif
232
233 Q_INVOKABLE bool sendMessage(QObject *target, const QString &content, const QString &iconName = QString(), int duration = 4000, const QString &msgId = QString());
234 Q_INVOKABLE bool sendMessage(QObject *target, QQmlComponent *delegate, const QVariant &message, int duration = 4000, const QString &msgId = QString());
235 Q_INVOKABLE void closeMessage(DTK_QUICK_NAMESPACE::FloatingMessageContainer *message);
236 Q_INVOKABLE void closeMessage(QObject *target, const QString &msgId);
237 Q_INVOKABLE void sendSystemMessage(const QString &summary, const QString &body = QString(),
238 const QString &appIcon = QString(), const QStringList &actions = QStringList(),
239 const QVariantMap hints = QVariantMap(), const int timeout = 3000, const uint replaceId = 0);
240
241 static bool loadTranslator();
242
243#if QT_VERSION_MAJOR > 5
244 static QSGRootNode *getRootNode(QQuickItem *item);
245 static int &QSGNode_subtreeRenderableCount(QSGNode *node);
246 static QSGNode* &QSGNode_firstChild(QSGNode *node);
247 static QSGNode* &QSGNode_lastChild(QSGNode *node);
248 static QSGNode* &QSGNode_parent(QSGNode *node);
249#endif
250
251
252Q_SIGNALS:
253 void hasBlurWindowChanged();
254 void hasCompositeChanged();
255 void hasNoTitlebarChanged();
256 void hasAnimationChanged();
257 void hasInWindowBlurChanged();
258 void paletteChanged();
259 void inactivePaletteChanged();
260 void themeTypeChanged(DTK_GUI_NAMESPACE::DGuiApplicationHelper::ColorType themeType);
261
262
263private:
264 D_DECLARE_PRIVATE(DQMLGlobalObject)
265 D_PRIVATE_SLOT(void _q_onPaletteChanged())
266};
267
268DQUICK_END_NAMESPACE
269Q_DECLARE_METATYPE(DTK_QUICK_NAMESPACE::DColor)
270
271#endif // DQMLGLOBALOBJECT_P_H
DTK
提供一个全局的DTK 对象，保证QML中能够获取DTK 的相关枚举和函数.
Dtk::Quick::DColor
Definition dqmlglobalobject_p.h:37
Dtk::Quick::DPlatformThemeProxy
一个代理类，用于导出dtkgui的DPlatformTheme类的功能到QML使用，功能和接口基本和DPlatformTheme一致
Definition dplatformthemeproxy.h:19
Dtk::Quick::DQMLGlobalObjectPrivate
Definition dqmlglobalobject_p_p.h:17
Dtk::Quick::DQMLGlobalObject
Definition dqmlglobalobject_p.h:116
Dtk::Quick::DQuickDciIcon
A dci icon type for qml.
Definition dquickdciicon_p.h:23
Dtk::Quick::FloatingMessageContainer
Definition dmessagemanager_p.h:16
Dtk::Quick::DColor::Data::Color
Definition dqmlglobalobject_p.h:102