Warning, /plasma/kwin/doc/kwindecoration/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY % addindex "IGNORE">
0005 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0006 ]>
0007 
0008 <article id="kwindecoration" lang="&language;">
0009 <articleinfo>
0010 <authorgroup>
0011 <author>&Rik.Hemsley; &Rik.Hemsley.mail;</author>
0012 <author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
0013 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0014 </authorgroup>
0015 
0016 <date>2021-04-09</date>
0017 <releaseinfo>Plasma 5.21</releaseinfo>
0018 
0019 <keywordset>
0020 <keyword>KDE</keyword>
0021 <keyword>Systemsettings</keyword>
0022 <keyword>kwin</keyword>
0023 <keyword>window</keyword>
0024 <keyword>border</keyword>
0025 <keyword>theme</keyword>
0026 <keyword>style</keyword>
0027 </keywordset>
0028 </articleinfo>
0029 <sect1 id="window-deco">
0030 <title>Window Decorations</title>
0031 
0032 <para>This module allows you to select a style for the buttons and borders around
0033 the windows.</para>
0034 
0035 <sect2>
0036 <title>Window Decorations</title>
0037 
0038 <para>
0039 <screenshot>
0040 <screeninfo>Window Decoration Configuration Module</screeninfo>
0041   <mediaobject>
0042     <imageobject>
0043       <imagedata fileref="main.png" format="PNG"/>
0044     </imageobject>
0045     <textobject>
0046       <phrase>Window Decoration Configuration Module</phrase>
0047     </textobject>
0048   </mediaobject>
0049 </screenshot>
0050 </para>
0051 
0052 <para>Choose a window decoration style from the preview list, or
0053 download a new style using the <guibutton>Get New Window Decorations</guibutton>
0054 button.</para>
0055 
0056 <para>The default window decoration is called <quote>Breeze</quote>.</para>
0057 
0058 <para>Each style has a different look, but also a different
0059 <quote>feel</quote>. Some have (sometimes invisible)
0060 <quote>resize</quote> borders all around the edge, which make resizing
0061 easier but moving more difficult. Some have no borders on certain
0062 edges.</para>
0063 
0064 <para>You are encouraged to experiment with the different styles until
0065 you find one which best suits your pattern of work.</para>
0066 
0067 <para>In the preview of each style you find a <inlinemediaobject><imageobject>
0068 <imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject> 
0069 configure button to open configuration dialogs for the decoration.</para>
0070 
0071 <para>The options in this configuration dialog are applied to all windows. 
0072 Some window decorations (&eg; <quote>Breeze</quote>)
0073 provide a <guilabel>Window-Specific Overrides</guilabel> tab.
0074 On this tab you can change the border size and the visibility 
0075 of the window titlebar for particular windows.</para>
0076 
0077 <para>Different options for particular windows you find in the &systemsettings;
0078 module <ulink url="help:/kcontrol/windowspecific">Window Rules</ulink>.
0079 </para>
0080 
0081 <tip>
0082 <para>For accessibility purposes, some window decorations support
0083 extra wide borders.  If this is available, you can also choose a
0084 <guilabel>Window border size</guilabel> here.  The large borders are easier to see for low
0085 vision users, and easier to grab for people with limited mobility or
0086 difficulty using a mouse.</para>
0087 </tip>
0088 
0089 <tip>
0090 <para>If you are interested in creating your own window decoration, you can learn more about it <ulink url="https://develop.kde.org/docs/extend/plasma/aurorae/">in this tutorial</ulink>.</para>
0091 </tip>
0092 
0093 </sect2>
0094 
0095 <sect2>
0096 <title>Decorations</title>
0097 
0098 <para>In this dialog you can change the decoration of the window. 
0099 
0100 The available options depend on the selected style.
0101 </para>
0102 <para>
0103 <screenshot>
0104 <screeninfo>Breeze Decoration Options</screeninfo>
0105   <mediaobject>
0106     <imageobject>
0107       <imagedata fileref="decoration.png" format="PNG"/>
0108     </imageobject>
0109     <textobject>
0110       <phrase>Breeze Decoration Options</phrase>
0111     </textobject>
0112   </mediaobject>
0113 </screenshot>
0114 </para>
0115 </sect2>
0116 
0117 <sect2>
0118 <title>Titlebar Buttons</title>
0119 
0120 <para>This page allows you to customize the button location on the titlebar.
0121 You can drag buttons &eg; the <guilabel>Application menu</guilabel> into the 
0122 titlebar, remove them or drag around the
0123 buttons until you have the order that makes you comfortable.
0124 </para>
0125 
0126 <screenshot>
0127 <screeninfo>Button Options</screeninfo>
0128   <mediaobject>
0129     <imageobject>
0130       <imagedata fileref="button.png" format="PNG"/>
0131     </imageobject>
0132     <textobject>
0133       <phrase>Button Options</phrase>
0134     </textobject>
0135   </mediaobject>
0136 </screenshot>
0137 
0138 <para>Enable <guilabel>Close windows by double clicking the menu button</guilabel>
0139 to have an additional option to the Close button or if you have removed the Close button from the titlebar.
0140 </para>
0141 
0142 <para>Check the <guilabel>Show titlebar buttons tooltips</guilabel> item if you
0143 want to see the default tooltips when you hover the titlebar buttons with the mouse pointer.
0144 </para>
0145 
0146 </sect2>
0147 
0148 </sect1>
0149 
0150 </article>