# Chapitre 3. Configuration "bas niveau"

Normalement, vous n'avez pas besoin de changer à la main les options du fichier `Kwmrc`. A la place, vous pouvez utiliser le Panneau de Configuration qui permet de régler toutes ces options avec une interface graphique.

Ainsi, en ouvrant l'arborescence "Fenêtres", vous pouvez règler différentes options relatives aux fenêtres. Les raccourcis clavier peuvent être réglés via la section "Touches globales". Pour configurer les bureaux virtuels, ouvrez l'arborescence "Applications" et choisissez "Panneau".

Pour ceux qui préfèrent toutefois éditer un fichier de configuration, cette section explique les options du fichier `kwmrc` qui se touve dans /.kde/share/config.

# 3.1. Le fichier Kwmrc

Le fichier de configuration kwmrc est divisé en plusieurs parties :

- Buttons

- General

- Session

- Desktop

- Decoration

- Focus

- Sticky

## 3.1.1. [Buttons]

Cette section contrôle l'emplacement des boutons de contrôle des fenêtres dans la barre de titres. Elle contient des lignes de la forme suivante : BoutonX=nom-bouton où X est une lettre de A à F et nom-bouton est `Menu, Sticky, Iconify, Maximize, Close, Off`. Les boutons A, B et C apparaissent dans la partie gauche de la barre de titre, et D, E, and F apparaissent dans la partie droite.

## 3.1.2. [General]

Cette section définit des options de configuration diverses :

- AutoRaise=valeur (en millisecondes) Si `FocusPolicy` est `FocusFollowMouse`, cette option détermine le delay entre l'obtention du focus dans une fenêtre lorsque la souris y entre, et le moment où la fenêtre est affichée au premier plan.

- BorderSnapZone=valeur (en pixels) Lorsque l'utilisateur déplace une fenêtre et qu'un des bords de cette fenêtre s'approche du bord de l'écran, la fenêtre s'alignera sur le bord. valeur détermine la distance maximale de la fenêtre au bord de l'écran au moment du déclenchement de cet alignement.

- Button3Grab=`on|off` Si l'option est à `off`, les opérations sur les fenêtres exécutées à l'aide du bouton droit de la souris sont inopérantes, pour que les applications puissent recevoir les messages événements du bouton droit de la souris.

- ControlTab=`on|off` Si l'option est à `on`, elle permet à l'utilisateur de presser `Ctrl+Tab` afin de changer de bureau virtuel.

- ElectricBorder=valeur (en millisecondes) Lorsque vous avez plus d'un bureau virtuel, l'option ElectricBorder vous permet de changer de bureau en positionnant la souris sur l'extrémité du bureau courant. valeur indique la durée pendant laquelle vous devez laisser la souris dans cette zone avant qu'intervienne le changement de bureau. Une valeur de -1 désactive cette fonctionnalité.

- ElectricBorderPointerWarp=`NoWarp|MiddleWarp|FullWarp` Si l'option `ElectricBorder` est à `on`, utilisez cette option pour que la souris se retrouve à l'endroit précisé ici lors d'un changement de bureau.

- ElectricBorderNumberOfPushes=valeur (la valeur par défault est "5") Cette option est le nombre de positionnements de la souris sur la limite de l'écran pendant le laps de temps défini à l'option `ElectricBorder` avant le changement de bureau virtuel, sans déplacement de fenêtre.

- FocusPolicy=`ClickToFocus|FocusFollowMouse` `ClickToFocus` attend que l'utilisateur clique dans une fenêtre pour lui donner le focus dans cette fenêtre. `FocusFollowMouse` donne constamment le focus à la fenêtre dans laquelle se trouve le curseur.

- MaximizeOnlyVertically=`off|on` Si l'option est à `on`, la maximisation de la fenêtre sera limitée à la direction verticale.

- ResizeAnimation=`on|off` Si l'option est à `on`, les opérations de minimisation et de maximisation sont effectuées avec une animation graphique.

- RstartProtocol=`...` (la valeur par défaut est "rstart -v")

- ShapeMode=`off|on` Si l'option est à `on`, Kwm utilise des pixmaps définis par l'utilisateur pour les bords des fenêtres, au lieu des pixmaps par défaut (voir ci-dessous).

- ShapePixmapTop=pixmap ShapePixmapBottom=pixmap ShapePixmapLeft=pixmap ShapePixmapRight=pixmap ShapePixmapTopLeft=pixmap ShapePixmapTopRight=pixmap ShapePixmapBottomLeft=pixmap ShapePixmapBottomRight=pixmap Ces options précisent quelles images sont affichées dans les côtés/coins respectifs des fenêtres lorsque `ShapeMode` est à `on`. pixmap devrait être le nom d'un fichier pixmap (.xpm) qui doit se trouver dans share/apps/Kwm/pics.

  Les sources de Kwm incluent un sous-répertoire "images" contenant un exemple d'extensions de pixmaps.

- TitlebarLook=`shaded|plain|pixmap` Ce paramètre détermine l'apparence des barres de titre. Choisissez `pixmap` pour que Kwm affiche une image fournie par l'utilisateur dans la barre de titre, comme précisé par les options suivantes.

- TitlebarPixmapActive=pixmap TitlebarPixmapInactive=pixmap Ces options précisent quelles images sont affichées dans les barres de titre des fenêtres actives et inactives, respectivement, lorsque TitleBarLook est `pixmap`.

- TitleAnimation=valeur (en milliseconds) Activer TitleAnimation demande à Kwm de faire défiler continuellement les titres de fenêtre trop longs pour figurer en entier dans la barre de titre. valeur précise la vitesse de cette animation. Fixez-la à 0 pour désactiver cette fonctionnalité.

- TitlebarDoubleClickCommand=`winMaximize|winShade|winMove| winResize|winRestore|winIconify|winClose|winSticky| winOperations` Cette option vous permet de préciser quel comportement une fenêtre doit adopter lorsque l'utilisateur double-clique sur la barre de titres.

- TraverseAll=`on|off` Si l'option est à `on`, la commande `Alt-tab` boucle sur toutes les fenêtres et sur tous les bureaux virtuels. Si l'option est à `off`, `Alt-tab` boucle sur toutes les fenêtres uniquement sur le bureau virtuel courant.

- WindowMoveType=`Opaque|Transparent` Cette option contrôle l'affichage qui intervient lorsque l'utilisateur déplace une fenêtre d'un endroit à l'autre du bureau. `Transparent` montre seulement les bords de la fenêtre pendant le déplacement, et `Opaque` dessine la fenêtre dans son intégralité.

- WindowsPlacement=`cascade|interactive|manual|random|smart` Cette option détermine la politique de placement des fenêtres par Kwm sur le bureau lors de leur première ouverture. `manual` permet à l'utilisateur de placer la fenêtre lui-même. `interactive` se sert d'une valeur de pourcentage, comme suit : `WindowsPlacement=interactive,25` Avec `interactive`, Kwm utilise la politique `smart` pour placer la fenêtre sauf si la position projetée cacherait une ou des fenêtres à plus de la valeur de pourcentage précisée, dans quel cas la politique `manual` sera utilisée pour permettre à l'utilisateur de placer la fenêtre lui-même. Le pourcentage peut être supérieur à 100. Les options restantes laissent Kwm placer seul la fenêtre.

- WindowSnapZone=valeur (en pixels) Lorsque l'utilisateur positionne une fenêtre et que l'un des bords de la fenêtre s'approche du bord d'une autre fenêtre, elle se positionnera automatiquement contre le bord de l'autre. valeur précise la distance à laquelle les deux fenêtres devront se trouver lors du déclenchement de cette fonctionnalité.

## 3.1.3. [Session]

- proxyignore=`xemacs,xterm,...,` Liste de (non-KDE) applications séparées par une virgule, pour lesquelles l'état de la fenêtre n'a pas à être sauvé lors de la déconnexion de l'utilisateur. Précisez ici le nom de l'application ainsi que les paramètres de la ligne de commande avec lesquels vous appelez l'application.

## 3.1.4. [Desktop]

Cette partie définit le nombre de bureaux virtuels, leur nom, leur position. Elle contient des lignes du type suivant :

- NumberOfDesktops=valeur Précise le nombre de bureaux virtuels. A l'heure de l'écriture de ces lignes, Kwm prend en compte jusqu'à 8 bureaux.

- Desktop#[C]=name Précise le nom du bureau #, par exemple `Desktop1[C]=Premier` Les bureaux sont numérotés de 1 à 8.

- Desktop#Region=geometry Précise la taille du bureau #, par exemple `Desktop1Region=101+0+923+722` Notez que de modifier les régions dans le fichier de configuration aura très peu d'effetn comme kpanel indiquera à kwm des valeurs raisonnables pour le bureau courant dès son démarrage. Quand vous vous déconnectez, kwm enregistre ces nouveaux réglages.

## 3.1.5. [Decoration]

- noDecorationTitles=,

- tinyDecorationTitles=,

- noDecorationClasses=,

- tinyDecorationClasses=,

## 3.1.6. [Focus]

- noFocusTitles=,

- noFocusClasses=,

## 3.1.7. [Sticky]

- stickyTitles=,

- stickyClasses=,

Chaque propriété vous permet de spécifier une liste d'expressions régulières séparées par des virgules. Une fenêtre dont le titre ou la classe correspond à l'une de ces expressions sera décorée en conséquence. Note: Ces réglages affectent seulement les NOUVELLES fenêtres. N'oubliez pas d'appeler kwmcom `configure` ou de redémarrer `kwm` après avoir changé le fichier kwmrc.

Au lieu de bidouiller le fichier de configuration vous auriez peut-être intérêt à utiliser l'utilitaire `kstart` utility.