workspace/doc/kcontrol/kwindecoration/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <articleinfo>
  10
  11 <authorgroup>
  12 <author>&Rik.Hemsley; &Rik.Hemsley.mail;</author>
  13 <author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
  14 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  15 </authorgroup>
  16
  17 <date>2008-05-26</date>
  18 <releaseinfo>3.2</releaseinfo>
  19
  20 <keywordset>
  21 <keyword>KDE</keyword>
  22 <keyword>KControl</keyword>
  23 <keyword>kwin</keyword>
  24 <keyword>window</keyword>
  25 <keyword>border</keyword>
  26 <keyword>theme</keyword>
  27 <keyword>style</keyword>
  28 </keywordset>
  29 </articleinfo>
  30 <sect1 id="window-deco">
  31 <title>Window Decoration</title>
  32
  33 <para>This module allows you to select a style for the borders around
  34 windows.</para>
  35
  36 <sect2>
  37 <title>Window Decoration</title>
  38
  39 <para>
  40 <screenshot>
  41 <screeninfo>Window Decoration Configuration Module</screeninfo>
  42   <mediaobject>
  43     <imageobject>
  44       <imagedata fileref="main.png" format="PNG"/>
  45     </imageobject>
  46     <textobject>
  47       <phrase>Window Decoration Configuration Module</phrase>
  48     </textobject>
  49   </mediaobject>
  50 </screenshot>
  51 </para>
  52
  53 <para>Choose a window decoration style from the drop down box at the
  54 top of the screen to see a preview of it in the lower pane.</para>
  55
  56 <para>&kde; 4.1 default window decoration is called "Ozone".</para>
  57
  58 <para>Each style has a different look, but also a different
  59 <quote>feel</quote>. Some have (sometimes invisible)
  60 <quote>resize</quote> borders all around the edge, which make resizing
  61 easier but moving more difficult. Some have no borders on certain
  62 edges. One (<quote>BII</quote>) even has a dynamically sized and
  63 positioned title element.</para>
  64
  65 <para>You are encouraged to experiment with the different styles until
  66 you find one which best suits your pattern of work.</para>
  67
  68 <para>If there are any configurable options for the theme you chose in
  69 the drop down box, they will become available above the preview.</para>
  70
  71 <!--
  72 <para>In particular, if you chose to use the IceWM theme, you can choose
  73 here which of the many IceWM themes to use.  The IceWM theme has
  74 instructions on the page as to where you should copy the theme files,
  75 and once this is done, you can simply select the theme you want to
  76 use.</para>
  77 -->
  78
  79 </sect2>
  80
  81 <sect2>
  82 <title>Buttons</title>
  83
  84 <para>This page allows you to customize the buttons location on the titlebar. You can move Close button to the left for example. Check the <guilabel>Use custom titlebar button positions</guilabel> option in order to customize your titlebars. Then use the &kde; titlebar below and the buttons on its left and right to rearrange them as you want them.
  85 </para>
  86
  87 <para>
  88 <screenshot>
  89 <screeninfo>Window Decoration Configuration Module</screeninfo>
  90   <mediaobject>
  91     <imageobject>
  92       <imagedata fileref="buttons.png" format="PNG"/>
  93     </imageobject>
  94     <textobject>
  95       <phrase>Window Decoration Configuration Module</phrase>
  96     </textobject>
  97   </mediaobject>
  98 </screenshot>
  99 </para>
 100
 101 <para> By default, <guilabel>Show window button tooltips</guilabel> is checked and tooltips are shown.
 102 </para>
 103
 104 <para>This page has instructions directly on it - just drag around the
 105 buttons until you have the order that makes you comfortable.</para>
 106
 107 <note>
 108 <para>Not all the window decorations are able to comply with your custom
 109 set button order.  The ones that cannot are being converted, but at the
 110 time of this release they have not been all been changed.</para>
 111 </note>
 112
 113 <para>Apart from choosing the window decoration itself, you can choose
 114 here two further options: if there should be a tooltip while you hover
 115 your mouse over a window decoration button, and if the window
 116 decoration should attempt to use a custom set button order.</para>
 117
 118 <tip>
 119 <para>The tooltips can be quite useful if you have set a custom button
 120 order, and then changed to an unfamiliar window decoration.</para>
 121 </tip>
 122
 123 <tip>
 124 <para>For accessibility purposes, some window decorations support
 125 extra wide borders.  If this is available, you can also choose a
 126 border size here.  These large borders are easier to see for low
 127 vision users, and easier to grab for people with limited mobility or
 128 difficulty using a mouse.</para>
 129 </tip>
 130
 131 </sect2>
 132
 133 </sect1>
 134
 135 </article>