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 (⪚ <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 ⪚ 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>