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 à Paul Musti?re pour la traduction et à Jonathan Courtois, Claude Leloup et Jacques Thery pour leur relecture !