Page suivante Page précédente Table des matières Index KDE

4. 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 :

4.1 Les commandes de kpanel

Vous pouvez envoyer des commandes a 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 panneau, provoquant le rechargement de ses fichiers de configuration.

  • kpanel:hide cache le panneau sur l'écran courant, comme si l'utilisateur avait cliqué sur l'extrémité gauche du panneau.

  • kpanel:show réaffiche le panneau 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:#:bouton change l'icône affichée pour bouton sur le panneau. # 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.).

4.2 kpanelrc

kpanel peut être paramétré en utilisant le Centre de Contrôle KDE (Lanceur d'applications > Centre de Contrôle de KDE). Choisissez Panneau 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]

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

  • AutoHide=on|off
    Fixé à on, le panneau se cache automatiquement lorsque l'utilisateur déplace sa souris hors de la zone du panneau.

  • AutoHideTaskbar=on|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 panneau.

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

  • ClockAmPm=on|off
    Fixé à on, l'horloge du panneau 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 panneau. Utilisez un paramètre de police X11, comme *-times-medium-i-normal--12-*.

  • DateVisible=true|false
    Si false, cache l'horloge du panneau.

  • DesktopButtonFont=font
    Indique la police à utiliser pour les boutons d'écrans virtuels sur le panneau.

  • DesktopButtonHorizontalSize=valeur
    Indique la largeur des écrans virtuels sur le panneau. La valeur est multipliée par la moitié de BoxWidth.

  • DesktopButtonRows=value
    Indique le nombre de lignes pour les boutons des écrans virtuels sur le panneau.

  • FoldersFirst=on|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 panneau.

  • 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 panneau est caché. Il y a 8 positions prévues dans le réglage, correspondant aux 8 écrans virtuels. Un 0 dans la position indique que le panneau est visible sur le bureau virtuel correspondant ; un 1 signifie qu'il est caché. Par exemple, une configuration de 01011000 cache le panneau sur les bureaux 2, 4 et 5.

  • PersonalFirst=on|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|top|left|right
    Indique la position du panneau sur l'écran.

  • Style=normal|tiny|large
    Indique le style du panneau. Ce paramètre est utilisé par l'utilitaire de configuration graphique de kpanel (kcmkpanel) et n'affecte pas directement l'apparence du panneau.

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

  • TaskbarPosition=top|top_left|bottom|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.

[kpanelButtons]

Cette section traite de la configuration des boutons du panneau.

  • Buttons=button1, button2, ...
    La liste des boutons du panneau, où button# 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 panneau. 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 écrans 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 écrans virtuels et le bouton immédiatement à gauche/en haut.

Page suivante Page précédente Table des matières