D�finir l'ic�ne de l'application

L'ic�ne de l'application, typiquement affich�e dans le coin en haut � gauche, est d�finie en appelant la fonction QWidget::setWindowIcon().

D�finir l'ic�ne de l'application avec la plupart des bureaux Linux
K Desktop Environment (KDE)	GNOME

Pour changer l'ic�ne de l'ex�cutable de l'application, comme repr�sent�e sur le bureau (c'est-�-dire avant de lancer l'application), il est n�cessaire d'appliquer une technique diff�rente, qui d�pend de la plateforme.

D�finir l'ic�ne de l'application sous Windows

Premi�rement, cr�ez une image au format ICO, qui contient votre image d'ic�ne. Ceci peut �tre fait avec Microsoft Visual C++ : s�lectionnez Fichier|Nouveau, puis, dans l'onglet Fichier, choisissez Ic�ne (notez que vous n'avez pas besoin de charger l'application dans Visual C++ ; nous nous servons juste de l'�diteur d'ic�ne).

Mettez le fichier ICO dans le dossier source de votre application, par exemple, avec le nom myappico.ico. Ensuite, cr�ez un fichier nomm�, disons, myapp.rc, dans lequel vous mettez une seule ligne de texte :

 IDI_ICON1               ICON    DISCARDABLE     "myappico.ico"

Ensuite, en supposant que vous utilisiez qmake pour g�n�rer vos Makefiles, ajoutez cette ligne � votre fichier myapp.pro :

 RC_FILE = myapp.rc

R�g�n�rez votre Makefile et votre application. Le fichier .exe aura votre ic�ne dans l'explorateur de fichiers.

Si vous n'utilisez pas qmake, les �tapes n�cessaires sont : premi�rement, lancez le programme rc sur votre fichier .rc, puis linkez votre application avec le fichier r�sultant .res.

D�finir l'ic�ne de l'application sous Mac OS X

L'ic�ne de l'application, typiquement affich�e dans le dock, est d�finie en appelant la fonction QWidget::setWindowIcon(). Il est possible que le programme apparaisse dans le dock avant que la fonction ne soit appel�e, ce qui causera l'affichage d'une ic�ne par d�faut pendant l'animation de rebondissement.

Pour �tre s�r que la bonne ic�ne apparaisse, aussi bien quand l'application est lanc�e et dans le Finder, il est n�cessaire d'employer une technique sp�cifique � la plateforme.

Bien que beaucoup de programmes puissent cr�er des fichiers ic�nes (.icns), nous recommandons d'utiliser le programme Icon Composer fourni par Apple (dans le dossier Developer/Application). Icon Composer permet d'importer plusieurs ic�nes de tailles diff�rentes (pour diff�rents contextes), ainsi que des masques associ�s. Sauvegardez votre ensemble d'ic�nes dans le dossier de votre projet.

Si vous utilisez qmake pour g�n�rer vos Makefiles, vous devez juste ajouter une simple ligne � votre fichier .pro. Par exemple, si le nom de votre ic�ne est myapp.icns et celui de votre fichier projet myapp.pro, ajoutez cette ligne au fichier myapp.pro :

ICON = myapp.icns

Cela fera en sorte que qmake mette votre ic�ne dans le bon endroit et cr�e une entr�e Info.plist pour votre ic�ne.

Si vous n'utilisez pas qmake, vous devez faire manuellement les �tapes suivantes.

1. Cr�ez un fichier Info.plist pour votre application (avec le programme PropertyListEditor, qui est dans Developer/Applications).
2. Associez votre .icns avec CFBundleIconFile dans le fichier Info.plist (aussi avec le programme PropertyListEditor).
3. Copiez le fichier Info.plist dans le dossier Contents de votre application.
4. Copiez le fichier .icns dans le dossier Contents/Resources de votre application.

D�finir l'ic�ne de l'application avec la plupart des bureaux Linux

Dans cette partie, nous d�crivons bri�vement les probl�mes li�s � l'ajout d'ic�nes aux applications pour deux environnements de bureau Linux communs : KDE et GNOME. La technologie centrale utilis�e pour d�crire les ic�nes des applications est la m�me pour les deux bureaux et peut �ventuellement s'appliquer � d'autres, mais il y a des d�tails sp�cifiques � chaque bureau. La principale source d'information pour les standards utilis�s par ces deux bureaux Linux est freedesktop.org. Pour plus d'informations sur les autres bureaux Linux, veuillez vous reporter � la documentation des bureaux auxquels vous vous int�ressez.

Souvent, les utilisateurs ne lancent pas directement les ex�cutables, mais utilisent des ic�nes sur le bureau. Ces ic�nes sont les repr�sentations des « fichiers d'entr�es de bureau » qui contiennent une description de l'application, dont des informations sur son ic�ne. Les deux environnements de bureau sont capables de retrouver les informations dans ces fichiers et les utilisent pour cr�er des raccourcis vers les applications sur le bureau et sur le menu d�marrer.

Plus d'informations � propos des fichiers d'entr�es de bureau peuvent �tre trouv�es dans les sp�cifications des entr�es de bureau.

Bien que les fichiers d'entr�es de bureau puissent �tre inclus dans les d�tails de l'application, nous devons mettre les ic�nes dans l'endroit conventionnel pour chaque environnement de bureau. Un nombre d'endroits pour les ic�nes sont donn�s dans les sp�cifications de th�me d'ic�nes.

Bien que le chemin utilis� pour trouver les ic�nes d�pende de l'environnement de bureau et de sa configuration, la structure de dossier de chacun d'eux est bas�e sur la m�me organisation : les sous-dossiers sont arrang�s par th�me, taille d'ic�ne et type d'application. G�n�ralement, les ic�nes des applications sont ajout�es dans le th�me hicolor, donc une ic�ne carr�e de 32 pixels de c�t� d'une application devrait �tre mise dans le dossier hicolor/32 × 32/apps sous le chemin de l'ic�ne.

Les ic�nes des applications peuvent �tre install�es pour tous les utilisateurs ou selon les utilisateurs. Un utilisateur connect� � son bureau KDE peut d�couvrir ces emplacements en utilisant kde-config, par exemple, en �crivant dans un terminal la commande :

kde-config --path icon

Typiquement, la liste de chemins, s�par�s par des deux points, affich�e dans

stdout

inclut le chemin pour les ic�nes de l'utilisateur et celui pour tous. Sous ces dossiers, il est possible de trouver et d'installer les ic�nes selon les conventions d�crites dans les sp�cifications de th�me d'ic�nes.

Si vous d�veloppez exclusivement sous KDE, vous voudrez peut-�tre utiliser le syst�me de compilation de KDE pour configurer votre application. Ceci assure que vos ic�nes seront install�es dans les emplacements appropri�s sous KDE.

Le site des d�veloppeurs de KDE est http://developer.kde.org/.

GNOME

Les ic�nes des applications sont stock�es dans un dossier standard pour tous les utilisateurs contenant des fichiers ind�pendants de l'architecture. Cet emplacement peut �tre d�termin� avec gnome-config, par exemple, en �crivant dans un terminal la commande :

gnome-config --datadir

Le chemin affich� dans stdout r�f�re � un emplacement qui doit contenir un dossier appel� pixmaps; la structure de ce dossier pixmaps est d�crite dans les sp�cifications de th�me d'ic�nes.

Si vous d�veloppez exclusivement pour GNOME, vous voudrez peut-�tre utiliser l'ensemble standard d'outils de compilation GNU, aussi d�crit dans une partie du livre de d�veloppement d'application sous GTK+/GNOME. Ceci assure que vos ic�nes seront install�es dans les emplacements appropri�s de KDE.

Le site de d�veloppeurs de GNOME est http://developer.gnome.org/.

D�finir l'ic�ne de l'application sous Symbian

Pour d�finir l'ic�ne de l'application pour les applications Symbian, vous avez besoin d'une ic�ne SVG-T. Pour plus d'informations sur la cr�ation d'ic�nes SVG-T valides, veuillez vous reporter � http://wiki.forum.nokia.com/index.php/How_to_create_application_icon(SVG)_in_S60_3rd_edition/.

Une fois l'ic�ne disponible dans le bon format, et en supposant que vous utilisiez qmake pour g�n�rer vos Makefiles, vous avez juste � ajouter une ligne dans votre fichier projet .pro. Par exemple, si le nom de votre ic�ne est myapp.svg et celui de votre fichier projet myapp.pro, ajoutez cette ligne au fichier myapp.pro :

 ICON = myapp.svg

Remerciements

Merci � <!buffer!> pour la traduction et � <!johnlamericain!>, <!ClaudeLELOUP!> et <!jacques_jean!> pour leur relecture !