runtime/doc/kcontrol/panelappearance/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>
  13 <firstname>Mike</firstname>
  14 <surname>McBride</surname>
  15 </author>
  16 <author>
  17 <firstname>Jost</firstname>
  18 <surname>Schenck</surname>
  19 </author>
  20 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  21 </authorgroup>
  22
  23 <date>2003-10-06</date>
  24 <releaseinfo>3.2</releaseinfo>
  25
  26 <keywordset>
  27 <keyword>KDE</keyword>
  28 <keyword>KControl</keyword>
  29 <keyword>panel</keyword>
  30 </keywordset>
  31 </articleinfo>
  32
  33 <sect1 id="panel">
  34 <title>Panel</title>
  35
  36 <para>Here you can configure the panel's overall appearance.</para>
  37
  38 <para>You can also have the icons themselves zoom out when the
  39 mouse is over them, with the <guilabel>Enable icon zooming</guilabel>
  40 option. You can choose to have tooltips appear when your mouse button is
  41 over an icon, by enabling the <guilabel>Show tooltips</guilabel>
  42 option.</para>
  43
  44 <sect2 id="button-backgrounds">
  45 <title>Button Backgrounds</title>
  46
  47 <para>The &kde; panel supports so-called <guilabel>Button
  48 Backgrounds</guilabel>. This means that the buttons shown on the panel
  49 will be drawn using configurable images. To enable button backgrounds,
  50 simply choose the button type from the list, and change the drop down
  51 box to the color image you would like to use.  Choose
  52 <guilabel>Default</guilabel> to return to an unstyled button.  If you
  53 choose <guilabel>Custom color</guilabel>, the color button next to the
  54 drop down list will be enabled.  Click on it to select a custom color
  55 to use.</para>
  56
  57 </sect2>
  58
  59 <sect2 id="panel-background">
  60 <title><guilabel>Panel Background</guilabel></title>
  61
  62 <para><guilabel>Enable transparency</guilabel> to turn the entire
  63 panel transparent.  The desktop background will show through instead
  64 of a background image or color.</para>
  65
  66 <para>There will still be small handles beside each applet, to allow
  67 you to locate, move, and configure them.  These can be turned off in
  68 the <guilabel>Advanced Options</guilabel></para>
  69
  70 <para>If you check <guilabel>Enable background image</guilabel> a
  71 picture will be used to draw the panel's background, just as you
  72 can use a picture for the desktop background. You can specify an image
  73 file in the line edit box below or choose one by clicking on the
  74 <guibutton>Browse</guibutton> button. You'll see a preview of the
  75 selected picture on the right.</para>
  76
  77 <para>The image can be tinted on-the-fly by enabling the option
  78 <guilabel>Colorize to match the desktop color scheme</guilabel>.  You
  79 might use a grayscale texture that is tinted in this manner, to create
  80 a particular effect.</para>
  81 </sect2>
  82
  83 <sect2 id="advanced-options">
  84 <title><guilabel>Advanced Options</guilabel></title>
  85
  86 <para>The <guilabel>Hide button size:</guilabel> option allows you to
  87 choose a width in pixels for the hide buttons, if they are
  88 visible.</para>
  89
  90 <para>The panel itself has several default sizes set, which you can
  91 switch between by simply dragging the edge of it, or by &RMB; clicking
  92 on an empty space in the panel, choosing <guisubmenu>Size</guisubmenu>
  93 and selecting the desired size from the submenu.  If you enable
  94 <guilabel>Allow Drag and Drop resizing of panels</guilabel> then by
  95 choosing <guimenuitem>Custom</guimenuitem> in the panel menu, you can
  96 drag the panel edge to any size you like.</para>
  97
  98 <para>Applet handles are normally visible beside each applet on the panel, so that it is clear where to click to configure them, or to get to the panel menu.  You can instead have them <guilabel>Fade out</guilabel>, or hide unless you hover the mouse over them, or you can choose to <guilabel>Hide</guilabel> them completely.</para>
  99
 100 <para>Finally, if the panel is transparent, you can tint it with a
 101 color of your choice.  The slider allows you to choose how opaque the
 102 tint is.  At the lowest end, there is no tint visible, while at the
 103 highest, the panel is not transparent at all.</para>
 104
 105 </sect2>
 106
 107 <sect2 id="panel-author">
 108 <title>Section Author</title>
 109 <para>This section written by: Jost Schenck <email>jost@schenck.de</email></para>
 110 <para>Minor update by Mike McBride
 111 <email>mpmcbride7@yahoo.com</email></para>
 112
 113 <para>Some new options added by Lauri Watts
 114 <email>lauri@kde.org</email></para>
 115
 116 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 117
 118 </sect2>
 119
 120 </sect1>
 121
 122 </article>