<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- desktop-integration.qdoc -->
<head>
<title>Qt 4.6: Desktop Integration</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td></tr></table><h1 class="title">Desktop Integration<br /><span class="subtitle"></span>
</h1>
<p>Qt applications behave well in the user's desktop environment, but certain integrations require additional, and sometimes platform specific, techniques.</p>
<ul><li><a href="#useful-classes">Useful Classes</a></li>
<li><a href="#setting-the-application-icon">Setting the Application Icon</a></li>
<li><a href="#opening-external-resources">Opening External Resources</a></li>
<li><a href="#system-tray-icons">System Tray Icons</a></li>
<li><a href="#desktop-widgets">Desktop Widgets</a></li>
</ul>
<a name="useful-classes"></a>
<h3>Useful Classes</h3>
<p>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.</p>
<p><table width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0">
<tr valign="top" class="odd"><th><a href="qdesktopservices.html">QDesktopServices</a></th><td>Methods for accessing common desktop services</td></tr>
<tr valign="top" class="even"><th><a href="qdesktopwidget.html">QDesktopWidget</a></th><td>Access to screen information on multi-head systems</td></tr>
<tr valign="top" class="odd"><th><a href="qsystemtrayicon.html">QSystemTrayIcon</a></th><td>Icon for an application in the system tray</td></tr>
</table></p>
<a name="setting-the-application-icon"></a>
<h3>Setting the Application Icon</h3>
<p>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.</p>
<ul><li><a href="appicon.html#setting-the-application-icon-on-windows">Setting the Application Icon on Windows</a></li>
<li><a href="appicon.html#setting-the-application-icon-on-mac-os-x">Setting the Application Icon on Mac OS X</a></li>
<li><a href="appicon.html#setting-the-application-icon-on-common-linux-desktops">Setting the Application Icon on Common Linux Desktops</a></li>
<ul><li><a href="appicon.html#k-desktop-environment-kde">K Desktop Environment (KDE)</a></li>
<li><a href="appicon.html#gnome">GNOME</a></li>
</ul>
<li><a href="appicon.html#setting-the-application-icon-on-the-symbian-platform">Setting the Application Icon on the Symbian platform</a></li>
</ul>
<a name="opening-external-resources"></a>
<h3>Opening External Resources</h3>
<p>Although Qt provides facilities to handle and display resources, such as <a href="qimageiohandler.html">common image formats</a> and <a href="qtextdocument.html">HTML</a>, it is sometimes necessary to open files and external resources using external applications.</p>
<p><a href="qdesktopservices.html">QDesktopServices</a> provides an interface to services offered by the user's desktop environment. In particular, the <a href="qdesktopservices.html#openUrl">openUrl()</a> function is used to open resources using the appropriate application, which may have been specifically configured by the user.</p>
<a name="system-tray-icons"></a>
<h3>System Tray Icons</h3>
<p>Many modern desktop environments feature docks or panels with <i>system trays</i> 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.</p>
<p>The <a href="qsystemtrayicon.html">QSystemTrayIcon</a> class exposes all of the above features via an intuitive Qt-style API that can be used on all desktop platforms.</p>
<a name="desktop-widgets"></a>
<h3>Desktop Widgets</h3>
<p>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.</p>
<p>The <a href="qdesktopwidget.html">QDesktopWidget</a> 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.</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="40%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td>
<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="40%" align="right"><div align="right">Qt 4.6.3</div></td>
</tr></table></div></address></body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
8e6051afcdb111a0317a58fb64c2abf5
>
files
>
604
