Long live Qt!

1 files changed, 90 insertions, 0 deletions

diff --git a/doc/src/desktop-integration.qdoc b/doc/src/desktop-integration.qdoc
new file mode 100644
index 0000000..e52b8d8
--- /dev/null
+++ b/doc/src/desktop-integration.qdoc
@@ -0,0 +1,90 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain
+** additional rights. These rights are described in the Nokia Qt LGPL
+** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+  \page desktop-integration.html
+  \title Desktop Integration
+  \ingroup gui-programming
+
+  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.
+
+  \tableofcontents
+
+  \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.
+
+
+*/