1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia. For licensing terms and
** conditions see http://qt.digia.com/licensing. For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\page desktop-integration.html
\title Desktop Integration
\brief Integrating with the user's desktop environment.
\ingroup best-practices
\ingroup qt-gui-concepts
Qt applications behave well in the user's desktop environment, but certain
integrations require additional, and sometimes platform specific, techniques.
\tableofcontents
\section1 Useful Classes
Various classes in Qt are designed to help developers integrate applications into
users' desktop environments. These classes enable developers to take advantage
of native services while still using a cross-platform API.
\annotatedlist desktop
\section1 Setting the Application Icon
In order to change the icon of the executable application file
itself, as it is presented on the desktop (i.e., prior to
application execution), it is necessary to employ another,
platform-dependent technique.
\tableofcontents {1 Setting the Application Icon}
\section1 Opening External Resources
Although Qt provides facilities to handle and display resources, such as
\l{QImageIOHandler}{common image formats} and \l{QTextDocument}{HTML},
it is sometimes necessary to open files and external resources using external
applications.
QDesktopServices provides an interface to services offered by the user's desktop
environment. In particular, the \l{QDesktopServices::}{openUrl()} function is
used to open resources using the appropriate application, which may have been
specifically configured by the user.
\section1 System Tray Icons
Many modern desktop environments feature docks or panels with \e{system trays}
in which applications can install icons. Applications often use system tray icons
to display status information, either by updating the icon itself or by showing
information in "balloon messages". Additionally, many applications provide
pop-up menus that can be accessed via their system tray icons.
The QSystemTrayIcon class exposes all of the above features via an intuitive
Qt-style API that can be used on all desktop platforms.
\section1 Desktop Widgets
On systems where the user's desktop is displayed using more than one screen,
certain types of applications may need to obtain information about the
configuration of the user's workspace to ensure that new windows and dialogs
are opened in appropriate locations.
The QDesktopWidget class can be used to monitor the positions of widgets and
notify applications about changes to the way the desktop is split over the
available screens. This enables applications to implement policies for
positioning new windows so that, for example, they do not distract a user
who is working on a specific task.
*/
|
