Debian Codegraph @

src/util/dtaskbarcontrol.cpp

raw
1 // SPDX-FileCopyrightText: 2022 UnionTech Software Technology Co., Ltd.
2 //
3 // SPDX-License-Identifier: LGPL-3.0-or-later
4
5 #include "dtaskbarcontrol.h"
6
7 #include <QVariant>
8 #include <QGuiApplication>
9 #include <QDBusMessage>
10 #include <QDBusConnection>
11 #include <QDebug>
12
13 #include "private/dtaskbarcontrol_p.h"
14
15 DCORE_USE_NAMESPACE
16 DGUI_BEGIN_NAMESPACE
17
18 DTaskbarControlPrivate::DTaskbarControlPrivate(DTaskbarControl *q)
19 : DObjectPrivate(q)
20 , m_counter(0)
21 , m_counterVisible(true)
22 , m_progress(0)
23 , m_progressVisible(true)
24 {
25
26 }
27
28 DTaskbarControlPrivate::~DTaskbarControlPrivate()
29 {
30
31 }
32
33 /*!
34 \class Dtk::Gui::DTaskbarControl
35 \inmodule dtkgui
36
37 \brief DTaskbarControl提供了一个Launcher API接口,用于方便应用程序控制taskbar进度条,设置当前任务数量.
38
39 如果想隐藏或者不使用进度条和任务数的显示,可以使用setProgress,setCounter 传递false隐藏相关显示.
40 */
41
42 DTaskbarControl::DTaskbarControl(QObject *parent)
43 : QObject(parent)
44 , DObject(*new DTaskbarControlPrivate(this))
45 {
46
47 }
48
49 DTaskbarControl::~DTaskbarControl()
50 {
51
52 }
53
54 /*!
55 \brief DTaskbarControl::setProgress 设置当前进度和进度条是否可见
56 \a progressVisible true可见 false不可见
57 \a progress 当前进度值 0-1(换算成百分比)
58 */
59 void DTaskbarControl::setProgress(bool progressVisible, double progress)
60 {
61 if (!qFuzzyCompare(d_func()->m_progress, progress)) {
62 d_func()->m_progress = progress;
63 Q_EMIT progressChanged(progress);
64 }
65
66 if (d_func()->m_progressVisible != progressVisible) {
67 d_func()->m_progressVisible = progressVisible;
68 Q_EMIT progressVisibleChanged(progressVisible);
69 }
70
71 QVariantMap properties;
72 properties.insert("progress-visible", progressVisible);
73 properties.insert("progress", progress);
74 sendMessage(properties);
75 }
76
77 /*!
78 \brief DTaskbarControl::setCounter 设置当前任务数量
79 \a counterVisible true任务数可见 false任务数不可见
80 \a counter
81 */
82 void DTaskbarControl::setCounter(bool counterVisible, int counter)
83 {
84 if (counter != d_func()->m_counter) {
85 d_func()->m_counter = counter;
86 Q_EMIT counterChanged(counter);
87 }
88
89 if (d_func()->m_counterVisible != counterVisible) {
90 d_func()->m_counterVisible = counterVisible;
91 Q_EMIT counterVisibleChanged(counterVisible);
92 }
93
94 QVariantMap properties;
95 properties.insert("count-visible", counterVisible);
96 properties.insert("count", counter);
97 sendMessage(properties);
98 }
99
100 /*!
101 brief DTaskbarControl::counter 获取当前任务数
102 return 任务数量
103 */
104 int DTaskbarControl::counter() const
105 {
106 return d_func()->m_counter;
107 }
108
109 /*!
110 \brief DTaskbarControl::setCounterVisible 设置任务数是否可见
111 \a counterVisible true可见 false不可见
112 如果需要隐藏,建议设置counter的值为0并且设置为false,只设置false,有可能会显示
113 */
114 void DTaskbarControl::setCounterVisible(bool counterVisible)
115 {
116 if (d_func()->m_counterVisible != counterVisible) {
117 d_func()->m_counterVisible = counterVisible;
118 Q_EMIT counterVisibleChanged(counterVisible);
119 }
120
121 QVariantMap properties;
122 properties.insert("count-visible", counterVisible);
123 sendMessage(properties);
124 }
125
126 /*!
127 \brief DTaskbarControl::counterVisible 返回任务数是否可见
128 \return true可见 false不可见
129 */
130 bool DTaskbarControl::counterVisible() const
131 {
132 return d_func()->m_counterVisible;
133 }
134
135 /*!
136 \brief DTaskbarControl::setUrgency 设置任务的紧急程度
137 \a val true 任务紧急 false普通任务
138 */
139 void DTaskbarControl::setUrgency(bool val)
140 {
141 QVariantMap properties;
142 properties.insert("urgent", val);
143 sendMessage(properties);
144 }
145
146 void DTaskbarControl::sendMessage(const QVariantMap &params)
147 {
148 if (QGuiApplication::desktopFileName().isEmpty()) {
149 qWarning() << "You need to set the desktop file name before you can use DTaskbarControl!";
150 return;
151 }
152
153 auto message = QDBusMessage::createSignal("/com/deepin/dtkgui/DTaskbarControl",
154 "com.canonical.Unity.LauncherEntry",
155 "Update");
156
157 message << "application://" + QGuiApplication::desktopFileName()
158 << params;
159 QDBusConnection::sessionBus().send(message);
160 }
161
162
163 DGUI_END_NAMESPACE