# Manuel de KPanel

L'équipe KDE
Version 0.19.1, 6 juin 1998

La dernière mise à jour de cette documentation se rapporte à la version 0.19.1 de kpanel. Veuillez s'il vous plaît adresser tout commentaire/addition à l'auteur.

Le manuel de KPanel

KDE
KPanel
gestionnaire d'applications

## Introduction

kpanel vous aide à lancer et gérer vos applications et bureaux virtuels dans l'environnement KDE. Il vous permet un accès rapide à de nombreuses fonctions, dont :

- le lanceur d'applications de KDE

- une barre des tâches regroupant les applications lancées

- des boutons pour lancer rapidement les applications les plus utilisées

- des bureaux virtuels

kpanel est hautement flexible et configurable, et peut être paramétré tant au niveau utilisateur qu'au niveau système. Ce document décrit comment configurer et utiliser kpanel.

### Fonctionnalités

kpanel inclut quelques fonctionnalités comme par exemple :

- tableau de bord et barre des tâches pouvant être positionnés indépendamment l'un de l'autre

- tableau de bord et barre des tâches pouvant se cacher automatiquement

- bulles d'aide configurables

- affichage possible de petites applications dans le tableau de bord lui-même

- possibilité de définir plusieurs icônes pour un même bouton sur le tableau de bord, et de passer de l'une à l'autre par les commandes de kpanel.

## Caractéristiques principales de l'affichage

kpanel affiche deux fenêtres : la barre des tâches et le tableau de bord.

- La barre des tâches affiche toutes les applications en train de s'exécuter.

- Le tableau de bord contient le menu de lancement des applications, un bouton pour l'affichage de la liste des fenêtres, les boutons d'accès aux bureaux virtuels, et enfin des boutons pour le lancement des applications les plus utilisées.

Le tableau de bord et la barre des tâches peuvent être positionnés indépendamment l'un de l'autre.

### La barre des tâches

La barre des tâches affiche la liste des applications en train de s'exécuter. Les titres des fenêtres icônifiées sont mis entre parenthèses. Un clic sur une des applications ainsi listées dans la barre des tâches vous positionne immédiatement dans l'application sélectionnée, en changeant de bureau virtuel si nécessaire.

De plus, vous pouvez vous servir du bouton droit de votre souris à tout endroit de la barre des tâches, et ainsi choisir, dans le menu qui s'affiche alors, parmi les options suivantes : maximiser, icônifier, fermer ou déplacer la fenêtre de l'application considérée sur le bureau virtuel courant.

### Le tableau de bord

Le tableau de bord apparaît par défaut au bas de votre écran. Il contient le menu lanceur d'applications, une horloge, ainsi que des boutons pour les applications les plus fréquemment utilisées, sans compter les bureaux virtuels. Vous pouvez le faire se dissimuler sur le bureau virtuel courant en cliquant son extrémité gauche (le tableau de bord restera visible sur les autres écrans virtuels). Vous pouvez également le configurer pour qu'il se cache automatiquement, auquel cas il disparaîtra jusqu'à ce que le curseur de votre souris atteigne le bord de l'écran auquel il est attaché.

Ci-dessous est donnée l'explication des icônes apparaissant par défaut sur le tableau de bord :

- Le lanceur d'applications

  En cliquant sur le gros K sur le tableau de bord, vous atteignez le menu des applications et programmes utilitaires, ainsi que les options d'accès au système d'aide et au centre de contrôle de KDE. Vous pouvez aussi ajouter ajouter vos propres applications à ce menu.

  Raccourci : `Alt-F1` affiche le lanceur d'applications.

- La liste des fenêtres

  Un clic sur le bouton ressemblant à un groupe de fenêtres ouvre un menu qui liste les applications lancées, regroupées par bureau virtuel. Un titre parenthésé indique que la fenêtre de l'application correspondante est icônifiée. Cliquez sur une application pour y accéder.

  Raccourci : cliquez sur le bouton du milieu de votre souris sur un espace vide sur le bureau pour afficher la liste des fenêtres.

- Répertoire Home

  Le bouton représentant une maison devant un dossier vous permet d'accéder rapidement aux fichiers de votre répertoire principal ou répertoire Home.

- Les bureaux virtuels Les boutons contenant du texte situés au milieu du tableau de bord, appelés par défaut "Premier", "Second", etc., vous permettent d'accéder aux bureaux virtuels. Le nombre de bureaux virtuels et leur nom peuvent être modifiés.

- Système d'aide en ligne par navigateur Le bouton représentant un livre vous donne accès au système d'aide en ligne de KDE, affiché dans le navigateur KDE.

En plus des icônes standard, vous pouvez ajouter vos propres boutons afin de lancer des programmes que vous utilisez fréquemment. De plus, les programmes peuvent être configurés pour être encapsulés dans la barre des tâches : par exemple, vous pouvez définir un bouton qui affiche un programme de notification d'arrivée de messages, et qui, de plus, lance un programme de gestion d'e-mail si vous cliquez dessus.

## Configuration du tableau de bord

kpanel est une partie hautement flexible et paramétrable de l'interface utilisateur de KDE. Cette section contient des instructions pour vous aider à le paramétrer à votre goût. Pour plus d'informations sur kpanelrc, le fichier de configuration de kpanel, veuillez vous référer à la section Guide du développeur.

Vous trouverez ci-dessous des instructions pour paramétrer

- le comportement et la position du tableau de bord

- les boutons du tableau de bord

- les bureaux virtuels

- le lanceur d'applications

### Comportement et position du tableau de bord

Pour paramétrer la position et le comportement du tableau de bord et de la barre d'outils, cliquez avec le bouton droit de votre souris sur un endroit vide de votre tableau de bord, et choisissez Configurer dans le menu. Cliquez sur le bouton d'aide pour obtenir des renseignements spécifiques sur tel ou tel réglage.

### Les boutons du tableau de bord

Vous pouvez déplacer, supprimer ou changer les propriétés d'un bouton du tableau de bord en cliquant dessus avec le bouton droit de votre souris, puis en choisissant l'option désirée dans le menu contextuel qui apparaît.

Pour ajouter un bouton au tableau de bord, utilisez une des trois méthodes suivantes :

- Pour placer un bouton liste des fenêtres sur le tableau de bord, choisissez Lanceur d'applications > tableau de bord > Ajouter la liste des fenêtres.

- Pour placer une application depuis le Lanceur d'applications jusque sur le tableau de bord, choisissez Lanceur d'applications > tableau de bord > Ajouter une application, puis continuez à naviguer dans le menu pour sélectionner l'application désirée. Vous pouvez également placer un sous-menu depuis le Lanceur d'applications directement sur le tableau de bord en utilisant la même méthode : lorsque vous atteignez le sous-menu désiré, sélectionnez le premier choix qui est le sous-menu lui-même. Par exemple, pour placer le sous-menu Paramètres sur le tableau de bord, choisissez Lanceur d'applications > tableau de bord > Ajouter une application > Système > Système.

- Faites glisser une icône depuis une fenêtre de kfm ou du bureau jusque sur le tableau de bord. Cette méthode n'est valable que pour les fichiers de type .kdelnk ou pour les répertoires contenant des fichiers de type .kdelnk. Une fois que vous avez placé un icône sur le tableau de bord, vous pouvez cliquer dessus avec le bouton droit de votre souris et choisir Propriétés dans le menu pour modifier son paramétrage. Remarque : lorsque vous placez une icône sur le tableau de bord de cette façon, faites attention à ne pas supprimer le fichier .kdelnk original, ou le dossier, car le tableau de bord ne serait alors plus capable d'afficher l'icône.

Bulles d'aide : kpanel affiche des bulles d'aide pour les boutons sur le tableau de bord et pour les programmes figurant dans le Lanceur d'applications. Pour modifier le texte de la bulle d'aide d'un bouton, cliquez dessus avec le bouton droit de votre souris et choisissez Propriétés dans le menu qui s'affiche. Sélectionnez l'onglet Application, et entrez le texte pour la bulle d'aide dans le champ Commentaire. Vous devrez probablement redémarrer kpanel avant de constater la prise en compte du nouveau texte (cliquez sur un endroit vide du tableau de bord avec le bouton droit de votre souris, et choisissez Redémarrer).

Encapsulation de programmes : Sur l'onglet Exécution d'une icône Application, l'option "Encapsulation dans le tableau de bord" vous permet de fixer l'affichage de ce programme dans le bouton lui-même, qui n'affichera alors plus une image statique mais bel et bien l'application. Cela est particulièrement utile pour des programmes de statut ou d'avertissement tels que xbiff. Voici comment procéder :

- Mettez dans le champ Exécuter le nom de l'application à exécuter dans le tableau de bord. Remarquez bien que c'est le réglage Exécuter dans la zone "Encapsulation dans le tableau de bord".

- Mettez dans le champ Titre de la fenêtre le titre de la fenêtre ouverte par l'application lorsqu'elle est normalement lancée depuis le bureau. kpanel utilise le titre des fenêtres pour identifier quelle fenêtre encapsuler dans le tableau de bord. Si la fenêtre n'a pas de barre de titre, lancez l'application depuis le bureau et regardez la barre des tâches pour savoir quel titre utiliser.

### Les bureaux virtuels

Pour changer le nom des bureaux virtuels sur le tableau de bord, ou modifier le nombre de bureaux virtuels, vous devez cliquer sur un endroit vide sur le tableau de bord avec le bouton droit de votre souris, et choisir Configurer dans le menu qui s'affiche alors. Cliquez sur l'onglet Bureaux dans la fenêtre de configuration de KPanel et effectuez les modifications nécessaires (vous pouvez cliquer sur Aide pour obtenir des informations spécifiques à tel ou tel réglage).

### Le lanceur d'applications

Pour paramétrer la partie utilisateur du lanceur d'applications, choisissez Lanceur d'applications > tableau de bord > Modifier les menus. Suivez les instructions dans le programme kmenuedit pour entrer vos choix.

Pour faire de votre propre sous-menu le menu principal, cliquez sur une zone vide du tableau de bord avec le bouton droit de votre souris, et choisissez Configurer dans le menu. Cliquez l'onglet Options et sélectionnez le choix "Personnel d'abord".

## Guide du développeur

Cette section couvre les sujets intéressant les utilisateurs experts ainsi que les développeurs d'applications. Les sujets suivants sont traités ici :

- les commandes de kpanel

- le fichier de configuration kpanelrc

### Les commandes de kpanel

Vous pouvez envoyer des commandes à kpanel par le gestionnaire de fenêtres KDE en utilisant l'une des deux techniques suivantes :

`KWM::sendKWMCommand(QString)` (dans une application KDE) ou bien `kwmcom commande` (depuis la ligne de commande)

kpanel reconnaît les commandes suivantes :

- kpanel:restart redémarre le tableau de bord, provoquant le rechargement de ses fichiers de configuration.

- kpanel:hide cache le tableau de bord sur l'écran courant, comme si l'utilisateur avait cliqué sur l'extrémité gauche du tableau de bord.

- kpanel:show réaffiche le tableau de bord s'il était caché.

- kpanel:system ouvre le Lanceur d'applications.

- kpanel:goXXXXYYYY ouvre le Lanceur d'applications à un endroit spécifique de l'écran. Par exemple, `kpanel:go05000100` ouvre le menu Lanceur d'applications aux coordonnées (500,100).

- kpanel:icon:&num;:bouton change l'icône affichée pour bouton sur le tableau de bord. &num; peut varier de 1 à 4, et se rapporte à l'icône définie pour le bouton dans le fichier .kdelnk dudit bouton (sur les lignes de la forme icon=pixmap, icon2=pixmap, etc.).

### kpanelrc

kpanel peut être paramétré en utilisant le Centre de Contrôle KDE (Lanceur d'applications > Centre de Contrôle de KDE). Choisissez tableau de bord dans la section Applications pour travailler sur les différentes options de configuration.

Pour ceux d'entre vous qui préfèrent modifier directement un fichier de configuration, cette section explique les options du fichier kpanelrc, qui se trouve dans ˜/.kde/share/config.

Le fichier de configuration kpanelrc se compose de deux parties :

- kpanel

- kpanelButtons

#### &lsqb;kpanel&rsqb;

La section kpanel contient les entrées qui contrôlent le comportement de kpanel.

- AutoHide=`on&verbar;off` Fixé à `on`, le tableau de bord se cache automatiquement lorsque l'utilisateur déplace sa souris hors de la zone du tableau de bord.

- AutoHideTaskbar=`on&verbar;off` Fixé à `on`, la barre des tâches se cache automatiquement lorsque l'utilisateur déplace sa souris hors de la barre des tâches.

- BackgroundTexture=pixmap Affiche pixmap comme texture de fond d'écran du tableau de bord.

- BoxHeight=valeur (en pixels) BoxWidth=valeur (en pixels) Ces paramètres déterminent respectivement la hauteur du tableau de bord et la largeur des boutons du tableau de bord.

- ClockAmPm=`on&verbar;off` Fixé à `on`, l'horloge du tableau de bord affiche un indicateur AM/PM ; sur `off`, l'horloge affiche l'heure au format 24h.

- DateFont=font Indique la police de caractères à utiliser pour l'horloge sur le tableau de bord. Utilisez un paramètre de police X11, comme `*-times-medium-i-normal--12-*`.

- DateVisible=`true&verbar;false` Si `false`, cache l'horloge du tableau de bord.

- DesktopButtonFont=font Indique la police à utiliser pour les boutons d'bureaux virtuels sur le tableau de bord.

- DesktopButtonHorizontalSize=valeur Indique la largeur des bureaux virtuels sur le tableau de bord. La valeur est multipliée par la moitié de `BoxWidth`.

- DesktopButtonRows=value Indique le nombre de lignes pour les boutons des bureaux virtuels sur le tableau de bord.

- FoldersFirst=`on&verbar;off` Lorsqu'il est fixé à `on`, les sous-menus du lanceur d'applications apparaissent toujours en haut. Quand il est à `off`, tous les choix apparaissent dans l'ordre alphabétique.

- Margin=valeur (en pixels) Cette valeur précise la taille des bordures haute et basse du tableau de bord.

- MenuToolTips=valeur (en millisecondes) Précise la durée pendant laquelle l'utilisateur doit maintenir sa souris au-dessus d'un objet du Lanceur d'applications avant de voir apparaître la bulle d'aide afférente.

- PanelHidden=00000000 Ce réglage fixe sur quels écrans le tableau de bord est caché. Il y a 8 positions prévues dans le réglage, correspondant aux 8 bureaux virtuels. Un 0 dans la position indique que le tableau de bord est visible sur le bureau virtuel correspondant ; un 1 signifie qu'il est caché. Par exemple, une configuration de 01011000 cache le tableau de bord sur les bureaux 2, 4 et 5.

- PersonalFirst=`on&verbar;off` Lorsqu'il est fixé à `on`, le menu personnel de l'utilisateur apparaît comme menu principal dans le Lanceur d'applications. Lorsqu'il est fixé à `off`, ce sont les menus par défaut de KDE qui sont les principaux.

- Position=`bottom&verbar;top&verbar;left&verbar;right` Indique la position du tableau de bord sur l'écran.

- Style=normal&verbar;tiny&verbar;large Indique le style du tableau de bord. Ce paramètre est utilisé par l'utilitaire de configuration graphique de kpanel (kcmkpanel) et n'affecte pas directement l'apparence du tableau de bord.

- TaskbarButtonHorizontalSize=valeur Un entier qui indique la largeur de la barre des tâches.

- TaskbarPosition=`top&verbar;top&lowbar;left&verbar;bottom&verbar;hidden` Indique la position de la barre des tâches sur l'écran. Si elle est fixée à `hidden`, la barre des tâches n'est pas visible.

#### &lsqb;kpanelButtons&rsqb;

Cette section traite de la configuration des boutons du tableau de bord.

- Buttons=button1, button2, ... La liste des boutons du tableau de bord, où button&num; peut être `system` (le lanceur d'applications), `windowlist` (la liste des fenêtres), ou le chemin absolu d'un fichier .kdelnk.

- ButtonDelta=delta1, delta2, ... Indique la position de chacun des boutons sur le tableau de bord. Les deltas sont des valeurs à virgule flottante, et pour chaque bouton, représentent la distance du bouton à celui immédiatement à gauche/en haut.

- control=valeur Indique après quel bouton est placé le groupe de boutons des bureaux virtuels. Si ce nombre est 0, le groupe vient immédiatement après le bouton K : s'il est à 1, il vient après le bouton qui suit le K, et ainsi de suite.

- controldelta=delta Précise la distance entre le groupe de boutons des bureaux virtuels et le bouton immédiatement à gauche/en haut.

## Remerciements

### Développeurs

`Matthias Ettrich` - Développeur

### Auteurs

`Stephen Schaub` - Auteur

`Robert Williams` - Editeur SGML

`Serge 'sergio' Tellène` - Traduction française