<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>
<title>Manuel de Kwm, le gestionnaire de fenêtres de KDE</title>
<authorgroup>
<author>
<surname>L'équipe KDE</surname>
</author>
</authorgroup>
<date>v0.19.15, 29 novembre 1998</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<abstract>
<para>Cette documentation se réfère à la version 0.19.15 de KWM.
Veuillez adresser tout commentaire et toute addition à l'auteur.</para>
<para>Le manuel de KWM</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KWM</keyword>
<keyword>gestionnaire de fenêtres</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title>Introduction</title>

<para>Cette documentation contient des informations d'ordre général sur <emphasis>Kwm</emphasis>,
un guide de référence des fonctionnalités et des informations techniques pour
les développeurs du <emphasis>Module de Contrôle de Kwm</emphasis> et du <emphasis>Module système des
sons</emphasis>.</para>

<para>Pour plus d'informations sur la personnalisation "bas niveau" de Kwm
(intéressant pour les développeurs de kwinconfig), vous pouvez consulter
le fichier Kwmrc, qui est généré automatiquement, et le code source.</para>

<para>A l'attention de tous les programmeurs : consultez <literal remap="tt">Kwm.h</literal> dans
libkdecore pour savoir comment utiliser Kwm pour vos besoins.
Pour ceux qui veulent programmer des modules, la classe
<literal remap="tt">KwmModuleApplication</literal> est un bon exemple.</para>
<sect1 id="Features">
<title>Fonctionnalités</title>

<para><emphasis>Kwm</emphasis> est le gestionnaire de fenêtres de prédilection pour KDE. 
Parmi les fonctionnalités qu'il offre, notons :</para>

<para><itemizedlist>
<listitem>
<para>Une intégration complète dans KDE.
</para>
</listitem>
<listitem>
<para>Un <link linkend="shortcuts">contrôle total par le clavier</link>.
</para>
</listitem>
<listitem>
<para>Un 'look and feel' avec des titres de fenêtres et des icônes uniques
et qui n'ont pas besoin d'être définis dans des fichiers de configuration
cryptiques.
</para>
</listitem>
<listitem>
<para>Une mini fenêtre <link linkend="minicli">ligne de commande</link>
avec historique des commandes pour accès rapide à un prompt shell.
</para>
</listitem>
<listitem>
<para>Reconfiguration possible pendant l'exécution sans besoin de redémarrer, y compris en
ce qui concerne la gestion de l'apparence ("look and feel") et des raccourcis clavier.
</para>
</listitem>
<listitem>
<para>Gestionnaire de fenêtres de seconde génération. Kwm utilise un toolkit
moderne pour les applications (boutons, menus, listes etc...) au lieu 
de proposer une implémentation propriétaire ou Xlib.
</para>
</listitem>
<listitem>
<para>Gestion excellente du focus, même si vous travaillez sur différents
bureaux virtuels (disparition des ennuis de perte de focus lors du changement
de bureau, comme il arrive couramment avec les autres gestionnaires de fenêtres.)
</para>
</listitem>
<listitem>
<para>Inclut l'utilitaire <literal remap="tt">kstart</literal> pour lancer des applications dans des fenêtres ayant des
propriétés KDE spéciales: sous forme d'icône, maximisée, dans un certain bureau virtuel, avec une certaine
décoration ou en les clouant. Tapez <literal remap="tt">kstart -help</literal> pour plus d'informations.
</para>
</listitem>
<listitem>
<para>Inclut une gestion des sessions et un proxy de gestion de session pour
les applications KDE. Ce proxy est capable de restaurer vos applications
dans l'état où vous les avez laissées à la déconnexion, tant avec les 
propriétés de fenêtres (maximisée, clouée au bureau, icônifiée, etc...)
qu'avec l'indication du bureau virtuel dont elles faisaient partie.
</para>
</listitem>
<listitem>
<para>Un concept moderne de modularisation qui utilise le serveur X lorsque
c'est possible. Les modules de Kwm sont aussi très indépendants : ils peuvent
être lancés avant ou après le démarrage de Kwm lui-même. Kwm peut être 
redémarré lorsque certains de ses modules sont actifs, et il s'y reconnectera
automatiquement.
</para>
</listitem>
<listitem>
<para>Des modules puissants, comme la barre de tâches de KDE (kpanel) et un
logiciel de commutation de bureau extrêmement séduisant.
</para>
</listitem>
<listitem>
<para>Il offre des extensions pour le serveur X dans <literal remap="tt">Kwm.h</literal> ;
les applications peuvent même à présent se maximiser (ou se clouer au bureau,
ou se décorer/redécorer etc...) et définit des mini-icônes. Ce comportement
fonctionne également pour les fenêtres mappées (visibles).</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="UtilisationdeemphasisKwmemphasis">
<title>Utilisation de <emphasis>Kwm</emphasis></title>

<sect1 id="options-de-la-ligne-de-commande">
<title>Options de la ligne de commande</title>

<para><emphasis>Kwm</emphasis> permet l'utilisation des options suivantes en ligne de commande :</para>

<para><variablelist>
<varlistentry>
<term> -version</term>
<listitem>
<para>Affiche le numéro de version ainsi que le numéro de patch ; 
ne lance pas Kwm</para>
</listitem>
</varlistentry>
<varlistentry>
<term> -nosession</term>
<listitem>
<para>Lance <emphasis>Kwm</emphasis> sans restaurer la session précédente.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="shortcuts">
<title>Raccourcis clavier</title>

<para>Les raccourcis globaux peuvent être configurés via le centre de contrôle. Voici une liste des
raccourcis tels qu'ils sont définis par défaut, sachant qu'ils peuvent être redéfinis.</para>

<para><variablelist>
<varlistentry>
<term>Alt-Esc ou Control-Esc </term>
<listitem>
<para>Affiche le gestionnaire de session avec un
bouton de sortie</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-Tab et Alt-Shift-Tab </term>
<listitem>
<para>Bascule entre les fenêtres du bureau actif</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-Tab et Ctrl-Shift-Tab </term>
<listitem>
<para>Bascule entre les bureaux virtuels
(désactivable dans Kwmrc)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F2 </term>
<listitem>
<para>Exécuter une commande</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F3 </term>
<listitem>
<para>Affiche le menu "Fenêtre"</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F4 </term>
<listitem>
<para>Ferme la fenêtre</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-F&lsqb;1..8&rsqb; </term>
<listitem>
<para>Bascule vers un bureau virtuel</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-Alt-Esc </term>
<listitem>
<para>Permet de détruire une fenêtre (le pointeur de la
souris devient une tête de mort)</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="controle-a-la-souris">
<title>Contrôle à la souris</title>

<para>Le contrôle à la souris obéit aux mêmes règles que les raccourcis clavier: il est configurable via
le centre de contrôle. Voici une liste de réglages par défaut.</para>

<para><emphasis remap="bf">Clic sur le bord de la fenêtre ou dans la barre de titre</emphasis>:
<itemizedlist>
<listitem>
<para>  <emphasis>bouton gauche :</emphasis> active la fenêtre et la place au premier plan </para>
</listitem>
<listitem>
<para>  <emphasis>bouton du milieu :</emphasis> active simplement la fenêtre sans la placer au premier plan</para>
</listitem>
<listitem>
<para>  <emphasis>bouton droit :</emphasis> affiche le menu "Fenêtre" si la fenêtre est active, sinon active simplement la fenêtre sans la placer au premier plan</para>
</listitem>
</itemizedlist>

<emphasis remap="bf">Double-clic sur la barre de titre : Maximise la fenêtre</emphasis>
<emphasis remap="bf">Clic maintenu sur la barre de titre</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>bouton gauche</emphasis> bouge la fenêtre et la fait passer au premier plan</para>
</listitem>
<listitem>
<para> <emphasis>bouton du milieu</emphasis> bouge la fenêtre en gardant l'organisation des fenêtres</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Etirement des coins ou des bords</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>bouton gauche</emphasis> redimensionne la fenêtre et la fait passer au premier plan</para>
</listitem>
<listitem>
<para> <emphasis>bouton du milieu</emphasis> redimensionne la fenêtre en gardant l'organisation des fenêtres</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Sur la fenêtre entière</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>Alt + bouton gauche</emphasis> bouge la fenêtre</para>
</listitem>
<listitem>
<para> <emphasis>Alt + bouton du milieu</emphasis> fait passer la fenêtre au premier plan</para>
</listitem>
<listitem>
<para> <emphasis>Alt + bouton droit</emphasis> redimensionne la fenêtre</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Options de la barre des titres (configurable)</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>Menu</emphasis> "Opérations fenêtre"</para>
</listitem>
<listitem>
<para> <emphasis>Clou</emphasis> Clouer/Déclouer la fenêtre (pour la faire apparaître sur tous les bureaux virtuels)</para>
</listitem>
<listitem>
<para> <emphasis>Iconifier</emphasis> Iconifier/Désiconifier la fenêtre</para>
</listitem>
<listitem>
<para> <emphasis>Maximiser</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>bouton gauche</emphasis> maximise</para>
</listitem>
<listitem>
<para> <emphasis>bouton du milieu</emphasis> maximise verticalement</para>
</listitem>
<listitem>
<para> <emphasis>bouton droit</emphasis> maximise horizontalement</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para> <emphasis>Fermeture</emphasis> ferme la fenêtre (le programme peut éventuellement réagir s'il a des choses à sauvegarder)</para>
</listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="minicli">
<title>Fenêtre mini-ligne de commande</title>

<para>Appuyez sur <literal remap="tt">Alt-F2</literal> pour afficher une fenêtre contenant la place pour
une ligne de commande. Entrez une commande shell UNIX (la variable
d'environnement SHELL est utilisée pour déterminer quel shell va exécuter la
commande), ou une parmi celles-ci :
<itemizedlist>
<listitem>
<para> Entrez une URL à afficher avec <emphasis>Kfm</emphasis>. Vous pouvez omettre
le http:// ou le ftp:// si le nom du serveur commence par www. ou ftp.
respectivement.
</para>
</listitem>
<listitem>
<para>Entrez <command>man:<replaceable>commande</replaceable></command> pour afficher la page du 
manuel Unix dans <emphasis>Kfm</emphasis> pour la commande 'commande'.</para>
</listitem>
</itemizedlist>
</para>

<para>Vous pouvez utiliser la touche flèche vers le haut pour rappeler les commandes
entrées précedemment dans cette boîte. De plus, vous pouvez utiliser la
touche Tab pour compléter des noms de fichier partiellement entrés, comme
dans de nombreux shells.</para>
</sect1>

<sect1 id="commandes">
<title>Commandes</title>

<para>Il est possible d'envoyer des commandes à Kwm par :</para>

<para><literal remap="tt"> Kwm::sendKwmCommand(QString)</literal> (dans les applications KDE)
ou
<command> Kwmcom <replaceable>commande</replaceable></command> (depuis la ligne de commande)</para>

<para>Ceci est notamment intéressant pour les développeurs de kglobalshortcut.</para>

<para>Pour le moment, <emphasis>Kwm</emphasis> comprend les commandes suivantes :
<itemizedlist>
<listitem>
<para><emphasis remap="bf">refreshScreen</emphasis> rafraîchit l'écran</para>
</listitem>
<listitem>
<para><emphasis remap="bf">darkenScreen</emphasis> provoque un écran noir. Attention: cette commande
rend le bureau sourd aux commandes clavier et souris.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">logout</emphasis> affiche la boîte de dialogue de déconnexion.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">commandLine</emphasis> ouvre la fenêtre de <link linkend="minicli">mini-ligne de commande</link></para>
</listitem>
<listitem>
<para><emphasis remap="bf">taskManager</emphasis> affiche le gestionnaire de la session courante.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">configure</emphasis> recharge la configuration depuis <link linkend="Kwmrc">Kwmrc</link>.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">winMove
winResize
winRestore
winIconify
winClose
winShade
winSticky
winOperations</emphasis>
Ces commandes affectent la fenêtre active courante et se comportent comme
vous l'attendez. (<literal remap="tt">winOperations</literal> affiche le menu des opérations de
fenêtre.)</para>
</listitem>
<listitem>
<para><emphasis remap="bf">deskUnclutter
deskCascade</emphasis>
Ces commandes réorganisent les fenêtres sur le bureau</para>
</listitem>
<listitem>
<para><emphasis remap="bf">desktop<emphasis>&lsqb;1-8&rsqb;</emphasis></emphasis> change vers le bureau virtuel précisé
desktop </para>
</listitem>
<listitem>
<para><emphasis remap="bf">desktop+1
desktop+2
desktop-1
desktop-2
desktop&percnt;2</emphasis>
Ces commandes changent le bureau virtuel actif. <literal remap="tt">desktop&percnt;2</literal> change entre
un bureau et le suivant ayant un numéro pair, c'est-à-dire de 1 à 2 ou de
3 à 4. Ce comportement est utile pour émuler "Haut" et "Bas" dans une matrice
virtuelle n*2, comme celle utilisée par le pager KDE. De même, <literal remap="tt">desktop+2</literal>
signifie "Droite", et <literal remap="tt">desktop-1</literal> signifie "Gauche".</para>
</listitem>
<listitem>
<para><emphasis remap="bf">go:autre</emphasis>
La commande <emphasis remap="bf">go</emphasis> sort de kwm et de tous ses modules et lance l'<emphasis remap="bf">autre</emphasis>
programme à la place. Par exemple <emphasis remap="bf">autre</emphasis> peut être le nom d'un autre gestionnaire de fenres comme
fvwm. Remarque: vous ne pouvez pas passer un chemin d'accès à la commande <emphasis remap="bf">go</emphasis>, mais vous devez vous
limiter au nom de l'exécutable, comme <literal remap="tt">kwmcom</literal> est limité à 20 caractères.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="Configurationbasniveau">
<title>Configuration "bas niveau"</title>

<para>Normalement, vous n'avez pas besoin de changer à la main les options du fichier
<literal remap="tt">Kwmrc</literal>. A la place, vous pouvez utiliser le Panneau de Configuration
qui permet de régler toutes ces options avec une interface graphique.</para>

<para>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".</para>

<para>Pour ceux qui préfèrent toutefois éditer un fichier de configuration, cette section explique les
options du fichier <literal remap="tt">kwmrc</literal> qui se touve dans  /.kde/share/config.</para>
<sect1 id="Kwmrc">
<title>Le fichier Kwmrc</title>

<para>Le fichier de configuration kwmrc est divisé en plusieurs parties :
<itemizedlist>
<listitem>
<para><link linkend="confButtons">Buttons</link></para>
</listitem>
<listitem>
<para><link linkend="confGeneral">General</link></para>
</listitem>
<listitem>
<para><link linkend="confSession">Session</link></para>
</listitem>
<listitem>
<para><link linkend="confDesktop">Desktop</link></para>
</listitem>
<listitem>
<para><link linkend="confDecoration">Decoration</link> </para>
</listitem>
<listitem>
<para><link linkend="confFocus">Focus</link> </para>
</listitem>
<listitem>
<para><link linkend="confSticky">Sticky</link> </para>
</listitem>
</itemizedlist>
</para>
<sect2 id="confButtons">
<title>&lsqb;Buttons&rsqb;</title>

<para>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 :
Bouton<emphasis>X</emphasis>=<emphasis>nom-bouton</emphasis>
où <emphasis>X</emphasis> est une lettre de A à F et <emphasis>nom-bouton</emphasis> est <literal remap="tt">Menu,
Sticky, Iconify, Maximize, Close, Off</literal>.  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. </para>
</sect2>
<sect2 id="confGeneral">
<title>&lsqb;General&rsqb;</title>

<para>Cette section définit des options de configuration diverses :
<itemizedlist>
<listitem>
<para><emphasis remap="bf">AutoRaise=<emphasis>valeur</emphasis> (en millisecondes)</emphasis> 
Si <literal remap="tt">FocusPolicy</literal> est <literal remap="tt">FocusFollowMouse</literal>, 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.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">BorderSnapZone=<emphasis>valeur</emphasis> (en pixels) </emphasis> 
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.
<emphasis>valeur</emphasis> détermine la distance maximale de la fenêtre au bord de l'écran
au moment du déclenchement de cet alignement.

</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Button3Grab=<literal remap="tt">on&verbar;off</literal></emphasis>
Si l'option est à <literal remap="tt">off</literal>, 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.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ControlTab=<literal remap="tt">on&verbar;off</literal></emphasis>  
Si l'option est à <literal remap="tt">on</literal>, elle permet à l'utilisateur de presser <literal remap="tt">Ctrl+Tab</literal>
afin de changer de bureau virtuel.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorder=<emphasis>valeur</emphasis> (en millisecondes)</emphasis>
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. <emphasis>valeur</emphasis> indique la durée pendant laquelle vous devez
laisser la souris dans cette zone avant qu'intervienne le changement de bureau.
Une <emphasis>valeur</emphasis> de -1 désactive cette fonctionnalité.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorderPointerWarp=<literal remap="tt">NoWarp&verbar;MiddleWarp&verbar;FullWarp</literal></emphasis> 
Si l'option <literal remap="tt">ElectricBorder</literal> est à <literal remap="tt">on</literal>, utilisez cette option
pour que la souris se retrouve à l'endroit précisé ici lors d'un changement
de bureau.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorderNumberOfPushes=<emphasis>valeur</emphasis></emphasis> (la valeur par défault est
"<emphasis remap="bf"><emphasis>5</emphasis></emphasis>") 
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 <literal remap="tt">ElectricBorder</literal>
avant le changement de bureau virtuel, sans déplacement de fenêtre.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">FocusPolicy=<literal remap="tt">ClickToFocus&verbar;FocusFollowMouse</literal></emphasis> 
<literal remap="tt">ClickToFocus</literal> attend que l'utilisateur clique dans une fenêtre pour lui
donner le focus dans cette fenêtre. <literal remap="tt">FocusFollowMouse</literal> donne constamment
le focus à la fenêtre dans laquelle se trouve le curseur.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">MaximizeOnlyVertically=<literal remap="tt">off&verbar;on</literal></emphasis> 
Si l'option est à <literal remap="tt">on</literal>, la maximisation de la fenêtre sera limitée à
la direction verticale.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ResizeAnimation=<literal remap="tt">on&verbar;off</literal></emphasis>  
Si l'option est à <literal remap="tt">on</literal>, les opérations de minimisation et de maximisation
sont effectuées avec une animation graphique.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">RstartProtocol</emphasis>=<literal remap="tt">...</literal> (la valeur par défaut est "<emphasis>rstart -v</emphasis>")
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ShapeMode=<literal remap="tt">off&verbar;on</literal></emphasis> 
Si l'option est à <literal remap="tt">on</literal>, <emphasis>Kwm</emphasis> utilise des pixmaps définis par l'utilisateur
pour les bords des fenêtres, au lieu des pixmaps par défaut (voir ci-dessous).
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ShapePixmapTop=<emphasis>pixmap</emphasis>  
ShapePixmapBottom=<emphasis>pixmap</emphasis> 
ShapePixmapLeft=<emphasis>pixmap</emphasis> 
ShapePixmapRight=<emphasis>pixmap</emphasis> 
ShapePixmapTopLeft=<emphasis>pixmap</emphasis> 
ShapePixmapTopRight=<emphasis>pixmap</emphasis> 
ShapePixmapBottomLeft=<emphasis>pixmap</emphasis> 
ShapePixmapBottomRight=<emphasis>pixmap</emphasis> </emphasis>
Ces options précisent quelles images sont affichées dans les côtés/coins
respectifs des fenêtres lorsque <literal remap="tt">ShapeMode</literal> est à <literal remap="tt">on</literal>. <emphasis>pixmap</emphasis>
devrait être le nom d'un fichier pixmap (.xpm) qui doit se trouver dans
share/apps/Kwm/pics.
</para>
<para>Les sources de Kwm incluent un sous-répertoire "images" contenant un exemple
d'extensions de pixmaps.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarLook=<literal remap="tt">shaded&verbar;plain&verbar;pixmap</literal></emphasis> 
Ce paramètre détermine l'apparence des barres de titre. Choisissez
<literal remap="tt">pixmap</literal> pour que <emphasis>Kwm</emphasis> affiche une image fournie par l'utilisateur
dans la barre de titre, comme précisé par les options suivantes.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarPixmapActive=<emphasis>pixmap</emphasis></emphasis>
<emphasis remap="bf">TitlebarPixmapInactive=<emphasis>pixmap</emphasis></emphasis>
Ces options précisent quelles images sont affichées dans les barres de titre
des fenêtres actives et inactives, respectivement, lorsque TitleBarLook est
<literal remap="tt">pixmap</literal>.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitleAnimation=<emphasis>valeur</emphasis> (en milliseconds) </emphasis>
Activer TitleAnimation demande à <emphasis>Kwm</emphasis> de faire défiler continuellement
les titres de fenêtre trop longs pour figurer en entier dans la barre de
titre. <emphasis>valeur</emphasis> précise la vitesse de cette animation. Fixez-la à 0
pour désactiver cette fonctionnalité.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarDoubleClickCommand=<literal remap="tt">winMaximize&verbar;winShade&verbar;winMove&verbar;
winResize&verbar;winRestore&verbar;winIconify&verbar;winClose&verbar;winSticky&verbar;
winOperations</literal> </emphasis> 
Cette option vous permet de préciser quel comportement une fenêtre doit
adopter lorsque l'utilisateur double-clique sur la barre de titres.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TraverseAll=<literal remap="tt">on&verbar;off</literal></emphasis>  
Si l'option est à <literal remap="tt">on</literal>, la commande <literal remap="tt">Alt-tab</literal> boucle sur toutes les
fenêtres et sur tous les bureaux virtuels. 
Si l'option est à <literal remap="tt">off</literal>, <literal remap="tt">Alt-tab</literal> boucle sur toutes les fenêtres
uniquement sur le bureau virtuel courant.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowMoveType=<literal remap="tt">Opaque&verbar;Transparent</literal></emphasis> 
Cette option contrôle l'affichage qui intervient lorsque l'utilisateur
déplace une fenêtre d'un endroit à l'autre du bureau. <literal remap="tt">Transparent</literal>
montre seulement les bords de la fenêtre pendant le déplacement, et
<literal remap="tt">Opaque</literal> dessine la fenêtre dans son intégralité.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowsPlacement=<literal remap="tt">cascade&verbar;interactive&verbar;manual&verbar;random&verbar;smart</literal></emphasis>  
Cette option détermine la politique de placement des fenêtres par <emphasis>Kwm</emphasis>
sur le bureau lors de leur première ouverture. <literal remap="tt">manual</literal> permet à
l'utilisateur de placer la fenêtre lui-même. <literal remap="tt">interactive</literal> se sert d'une
valeur de pourcentage, comme suit :
<literal remap="tt">WindowsPlacement=interactive,25</literal>
Avec <literal remap="tt">interactive</literal>, <emphasis>Kwm</emphasis> utilise la politique <literal remap="tt">smart</literal> 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
<literal remap="tt">manual</literal> 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 <emphasis>Kwm</emphasis> placer seul la fenêtre.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowSnapZone=<emphasis>valeur</emphasis> (en pixels) </emphasis> 
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. <emphasis>valeur</emphasis> précise la distance
à laquelle les deux fenêtres devront se trouver lors du déclenchement de cette
fonctionnalité.</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confSession">
<title>&lsqb;Session&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">proxyignore=<literal remap="tt">xemacs,xterm,...,</literal></emphasis> 
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.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confDesktop">
<title>&lsqb;Desktop&rsqb;</title>

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

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">NumberOfDesktops=<emphasis>valeur</emphasis> </emphasis>
Précise le nombre de bureaux virtuels. A l'heure de l'écriture de ces lignes,
<emphasis>Kwm</emphasis> prend en compte jusqu'à 8 bureaux.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Desktop<emphasis>&num;</emphasis>&lsqb;C&rsqb;=<emphasis>name</emphasis> </emphasis>
Précise le <emphasis>nom</emphasis> du bureau <emphasis>&num;</emphasis>, par exemple 
<literal remap="tt">Desktop1[C]=Premier</literal>
Les bureaux sont numérotés de 1 à 8.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Desktop<emphasis>&num;</emphasis>Region=<emphasis>geometry</emphasis> </emphasis>
Précise la taille du bureau <emphasis>&num;</emphasis>, par exemple 
<literal remap="tt">Desktop1Region=101+0+923+722</literal>

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. </para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confDecoration">
<title>&lsqb;Decoration&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">noDecorationTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">tinyDecorationTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">noDecorationClasses=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">tinyDecorationClasses=,</emphasis></para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confFocus">
<title>&lsqb;Focus&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">noFocusTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">noFocusClasses=,</emphasis></para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confSticky">
<title>&lsqb;Sticky&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">stickyTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">stickyClasses=,</emphasis></para>
</listitem>
</itemizedlist>

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.  
<emphasis>Note:</emphasis> Ces réglages affectent seulement les NOUVELLES fenêtres.
N'oubliez pas d'appeler <command>kwmcom <replaceable>configure</replaceable></command> ou de redémarrer <literal remap="tt">kwm</literal>
après avoir changé le fichier kwmrc.</para>

<para>Au lieu de bidouiller le fichier de configuration vous auriez peut-être intérêt à utiliser
l'utilitaire <literal remap="tt">kstart</literal> utility.</para>
</sect2>
</sect1>
</chapter>

<chapter id="Evnementssonores">
<title>Evénements sonores</title>

<para>Kwm peut lancer des événements sonores, qui peuvent être utilisés dans un
module sonore. Pour le moment, les événements sonores suivants sont
implémentés :
<itemizedlist>
<listitem>
<para>Iconification d'une fenêtre</para>
</listitem>
<listitem>
<para>Désiconification d'une fenêtre</para>
</listitem>
<listitem>
<para>Maximisation d'une fenêtre</para>
</listitem>
<listitem>
<para>Démaximisation d'une fenêtre</para>
</listitem>
<listitem>
<para>Clouage d'une fenêtre</para>
</listitem>
<listitem>
<para>Déclouage d'une fenêtre</para>
</listitem>
<listitem>
<para>Ouverture d'une fenêtre</para>
</listitem>
<listitem>
<para>Fermeture d'une fenêtre</para>
</listitem>
<listitem>
<para>Nouvelle boîte de dialogue</para>
</listitem>
<listitem>
<para>Fermeture d'une boîte de dialogue</para>
</listitem>
<listitem>
<para>Réduction d'une fenêtre en sa seule barre de titre</para>
</listitem>
<listitem>
<para>Restauration d'une seule barre de titre en fenêtre</para>
</listitem>
<listitem>
<para>Fermeture de session</para>
</listitem>
<listitem>
<para>Message de fermeture de session</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="QuestionsfrquemmentposesFAQ">
<title>Questions fréquemment posées (FAQ)</title>

<sect1 id="pourquoi-devrais-je-utiliser-kwm">
<title>Pourquoi devrais-je utiliser <emphasis>Kwm</emphasis>?</title>

<para>J'ai passé des jours entiers à apprendre comment configurer 10
gestionnaires de fenêtres différents. Et maintenant que j'ai
678 lignes de configuration qui font parfaitement ce que je souhaite,
vous arrivez et voulez m'en faire changer ?</para>

<para><emphasis remap="bf">Réponse</emphasis>: Vous n'êtes pas <emphasis>obligé</emphasis>, c'est une simple
<emphasis>suggestion</emphasis>. KDE fonctionne avec tous les gestionnaires de fenêtres courants,
mais, pour profiter de tous ses avantages, il est recommandé d'utiliser 
<emphasis>Kwm</emphasis>. Veuillez vous référer à la liste des <link linkend="Features">fonctionnalités</link>.</para>
</sect1>

<sect1 id="nouveaux-raccourcis-pour-mes-applications">
<title>Pourquoi ne puis-je pas définir de nouveaux raccourcis pour mes applications ?</title>

<para><emphasis remap="bf">Réponse</emphasis>: Parce que ce n'est pas le rôle du gestionnaire de fenêtres.
Toutefois, vous pouvez écrire une petite application qui fait cela.
En utilisant la classe KGlobalAccel de libkdecore, chaque application KDE a facilement
accès aux raccourcis globaux.</para>
</sect1>

<sect1 id="kwm-ressemble-t-il-a-windows-95">
<title>Pourquoi <emphasis>Kwm</emphasis> ressemble-t-il tant à Windows 95 ?</title>

<para><emphasis remap="bf">Réponse</emphasis>: Ah bon ? Voyons voir... (Matthias est en train d'essayer
de trouver quelqu'un qui a Windows 95 parce qu'il ne l'a sur aucun de ses
ordinateurs. Personne n'a Windows 95 ici ? Bien, prenons une vieille
distribution de Linux et installons fvwm95-2...) Non, décidément, impossible
de vérifier cela ! De toutes façons, Kwm est bien plus joli et offre plus de fonctions fondamentales.</para>
</sect1>

<sect1 id="extensions-de-kde">
<title>Est-il possible d'ajouter des extensions de KDE aux autres gestionnaires de fenêtres ?</title>

<para><emphasis remap="bf">Réponse</emphasis>: Bien sûr ! Il suffit d'aller dans
<literal remap="tt">Kwm.h</literal> et <literal remap="tt">Kwm.C</literal> dans <literal remap="tt">libkdecore</literal> et d'améliorer
votre gestionnaire de fenêtres favori pour qu'il réponde correctement à ce genre
de requêtes. Nous avons eu des échos selon lesquels certains gestionnaires de fenêtres
supportent ainsi déjà la totalité ou une partie de ces extensions.</para>
</sect1>

<sect1 id="degrades-a-la-openstep">
<title>Est-ce que <emphasis>Kwm</emphasis> supporte les dégradés à la <emphasis>OpenStep</emphasis> ?</title>

<para><emphasis remap="bf">Réponse</emphasis>: Oui.</para>
</sect1>
</chapter>

<chapter id="Conclusion">
<title>Conclusion</title>

<sect1 id="developpeur">
<title>Développeur</title>

<para><literal remap="tt"><ulink url="mailto:ettrich@kde.org">Matthias Ettrich</ulink></literal></para>
</sect1>

<sect1 id="auteurs">
<title>Auteurs</title>

<para><literal remap="tt"><ulink url="mailto:ettrich@kde.org">Matthias Ettrich</ulink></literal> - Design et auteur de <emphasis>Kwm</emphasis></para>

<para><literal remap="tt"><ulink url="mailto:sschaub@csmail.bju.edu">Stephen Schaub</ulink></literal> - Editeur</para>

<para><literal remap="tt"><ulink url="mailto:kalle@kde.org">Kalle Dalheimer</ulink></literal> - Copy editor</para>

<para><literal remap="tt"><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editeur et auteur SGML</para>

<para><literal remap="tt"><ulink url="mailto:fdarras@mail.dotcom.fr">François Darras</ulink></literal> - Version française SGML</para>

<para><literal remap="tt"><ulink url="mailto:tells@mygale.org">Serge 'sergio' Tellène</ulink></literal> - Mise à jour de la documentation pour v.0.11.5</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
