Warning, /plasma/plasma-workspace/doc/kcontrol/kcmstyle/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="kcmstyle" lang="&language;">
0009 <articleinfo>
0010 
0011 <title>Application Style</title>
0012 <authorgroup>
0013 <author>&Mike.McBride; &Mike.McBride.mail;</author>
0014 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0015 </authorgroup>
0016 
0017 <date>2021-04-09</date>
0018 <releaseinfo>Plasma 5.20</releaseinfo>
0019 
0020 <keywordset>
0021 <keyword>KDE</keyword>
0022 <keyword>System Settings</keyword>
0023 <keyword>style</keyword>
0024 <keyword>application</keyword>
0025 <keyword>widgets</keyword>
0026 </keywordset>
0027 </articleinfo>
0028 
0029 <para>This module is used to configure how the individual widgets are
0030 drawn by &plasma;.</para>
0031 
0032 <note><para>A <emphasis>Widget</emphasis> is a commonly-used
0033 programmer's term for referring to User Interface elements such as
0034 buttons, menus, and scroll bars.  You can think of them as the
0035 fundamental pieces that are assembled to make your
0036 application.</para></note>
0037 
0038 <para>You can configure how the widgets are drawn with this module,
0039 but to change the color of the widgets, you should refer to the
0040 section entitled <ulink
0041 url="help:/kcontrol/colors/index.html">Colors</ulink>.</para>
0042 
0043 <para>The top grid, labeled <guilabel>Application Style</guilabel> 
0044 contains a list of the previews of the pre-defined styles.
0045 Each style has a name, and a brief description is shown when you
0046 hover its item with the mouse pointer.</para>
0047 
0048 <para>If you want to configure a &plasma; theme, use the <guilabel>Configure Style...</guilabel> overlay
0049 icon at the bottom right of the widget style icon in the grid.</para>
0050 
0051 <para>If implemented, it is possible to change almost every aspect of the style: center tabbar tabs, draw toolbar item separators, draw focus indicator in lists, draw slider tick marks, enable extended resize handlers, define keyboard accelerators visibility, windows' drag mode, use frames for the better accessibility, use buttons on the scrollbars, use transparency in the menus.</para>
0052 
0053 <para>The general configuration can be made by pressing the <guibutton>Configure Icons and Toolbars</guibutton> button below the grid. This button opens a pane to select further settings.</para>
0054 <variablelist>
0055 
0056 <varlistentry> 
0057 <term><guilabel>Show icons: On buttons</guilabel></term>
0058 <listitem>
0059 <para>If this option is selected, action buttons (like <guibutton>OK</guibutton> and 
0060 <guibutton>Apply</guibutton>) will have a small icon located within them to act
0061 as a visual reference.  If this option is not selected, then only text
0062 will appear on the button.</para>
0063 </listitem> 
0064 </varlistentry> 
0065 
0066 <varlistentry> 
0067 <term><guilabel>Show icons: In menus</guilabel></term>
0068 <listitem>
0069 <para>If this option is selected, &kde; applications will show small icons alongside 
0070 most menu items.  If this option is not selected, then only text
0071 will appear in the menus. Changes to the visibility of menu icons will only affect newly started 
0072 applications.</para>
0073 </listitem> 
0074 </varlistentry> 
0075 
0076 <varlistentry> 
0077 <term><guilabel>Main toolbar label</guilabel>, <guilabel>Secondary toolbar label</guilabel></term>
0078 <listitem>
0079 <para>These drop down boxes let you determine where on the button in both toolbars the 
0080 text name of the button will appear as the default.  
0081 If <guilabel>None</guilabel> is selected, then there is no text on the toolbar buttons.  
0082 If  <guilabel>Text only</guilabel> is selected, then the button's icon is replaced with a text name of 
0083 the button. If <guilabel>Beside icons</guilabel> is selected, then the name of the button 
0084 will be placed to the <emphasis>right</emphasis> of the icon. 
0085 If <guilabel>Below icon</guilabel> is selected, the default will be to have the text 
0086 of the button <emphasis>below</emphasis> the icon.</para>
0087 
0088 <tip><para>These options only specify the <emphasis>default</emphasis> location.  
0089 Each application can override the settings used in this panel.</para></tip>
0090 </listitem> 
0091 </varlistentry> 
0092 
0093 </variablelist>
0094 
0095 <para>The <guibutton>Configure GNOME/GTK Application Style...</guibutton> button can be used to open the configuration tab where you can choose <guilabel>GTK theme</guilabel>, install GTK theme from file or <guibutton>Get New GNOME/GTK Application Styles</guibutton> from the Internet.
0096 </para>
0097 
0098 </article>