source: trunk/doc/src/desktop-integration.qdoc@ 321

Last change on this file since 321 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.

File size: 4.0 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information ([email protected])
5**
6** This file is part of the documentation of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42/*!
43 \page desktop-integration.html
44 \title Desktop Integration
45 \ingroup gui-programming
46
47 Various classes in Qt are designed to help developers integrate applications into
48 users' desktop environments. These classes enable developers to take advantage
49 of native services while still using a cross-platform API.
50
51 \tableofcontents
52
53 \section1 Opening External Resources
54
55 Although Qt provides facilities to handle and display resources, such as
56 \l{QImageIOHandler}{common image formats} and \l{QTextDocument}{HTML},
57 it is sometimes necessary to open files and external resources using external
58 applications.
59
60 QDesktopServices provides an interface to services offered by the user's desktop
61 environment. In particular, the \l{QDesktopServices::}{openUrl()} function is
62 used to open resources using the appropriate application, which may have been
63 specifically configured by the user.
64
65 \section1 System Tray Icons
66
67 Many modern desktop environments feature docks or panels with \e{system trays}
68 in which applications can install icons. Applications often use system tray icons
69 to display status information, either by updating the icon itself or by showing
70 information in "balloon messages". Additionally, many applications provide
71 pop-up menus that can be accessed via their system tray icons.
72
73 The QSystemTrayIcon class exposes all of the above features via an intuitive
74 Qt-style API that can be used on all desktop platforms.
75
76 \section1 Desktop Widgets
77
78 On systems where the user's desktop is displayed using more than one screen,
79 certain types of applications may need to obtain information about the
80 configuration of the user's workspace to ensure that new windows and dialogs
81 are opened in appropriate locations.
82
83 The QDesktopWidget class can be used to monitor the positions of widgets and
84 notify applications about changes to the way the desktop is split over the
85 available screens. This enables applications to implement policies for
86 positioning new windows so that, for example, they do not distract a user
87 who is working on a specific task.
88
89
90*/
Note: See TracBrowser for help on using the repository browser.