doc/src/desktop-integration.qdoc

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the documentation of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** No Commercial Usage
  11 ** This file contains pre-release code and may not be distributed.
  12 ** You may use this file in accordance with the terms and conditions
  13 ** contained in the Technology Preview License Agreement accompanying
  14 ** this package.
  15 **
  16 ** GNU Lesser General Public License Usage
  17 ** Alternatively, this file may be used under the terms of the GNU Lesser
  18 ** General Public License version 2.1 as published by the Free Software
  19 ** Foundation and appearing in the file LICENSE.LGPL included in the
  20 ** packaging of this file.  Please review the following information to
  21 ** ensure the GNU Lesser General Public License version 2.1 requirements
  22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  23 **
  24 ** In addition, as a special exception, Nokia gives you certain additional
  25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
  26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  27 **
  28 ** If you have questions regarding the use of this file, please contact
  29 ** Nokia at qt-info@nokia.com.
  30 **
  31 **
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  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 */