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>