summaryrefslogtreecommitdiffstats
path: root/kicker/taskbar/taskbar.kcfg
blob: 95596ad3426388f94456072d0972da0a1a6eec9d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
<?xml version="1.0" encoding="UTF-8"?>
<kcfg xmlns="http://www.kde.org/standards/kcfg/1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.kde.org/standards/kcfg/1.0
                          http://www.kde.org/standards/kcfg/1.0/kcfg.xsd" >
    <kcfgfile arg="true"/>

    <group name="General">
        <entry key="UseGlobalSettings" type="Bool" >
            <default>true</default>
            <label>Use the global taskbar configuration</label>
            <whatsthis>Turning this option off will cause the taskbar to ignore the global taskbar configuration, instead using a specific configuration for that particular taskbar.</whatsthis>
        </entry>
        <entry key="AllowDragAndDropReArrange" type="Bool" >
            <default>true</default>
            <label>Allow taskbar items to be rearranged using drag and drop</label>
            <whatsthis>Turning this option on will allow tasks on the taskbar to be manually rearranged using drag and drop.</whatsthis>
        </entry>
        <entry key="ShowAllWindows" type="Bool" >
            <default>true</default>
            <label>Show windows from all desktops</label>
            <whatsthis>Turning this option off will cause the taskbar to display <b>only</b> the windows on the current desktop. By default, this option is selected and all windows are shown.</whatsthis>
        </entry>
        <entry key="CycleWheel" type="Bool" >
            <default>true</default>
            <label>Cycle through windows with mouse wheel</label>
            <whatsthis>Enabling this option causes the taskbar to cycle through the current list of windows when using the mouse wheel</whatsthis>
        </entry>
        <entry key="ShowOnlyIconified" type="Bool" >
            <default>false</default>
            <label>Show only minimized windows</label>
            <whatsthis>Select this option if you want the taskbar to display <b>only</b> minimized windows. By default, this option is not selected and the taskbar will show all windows.</whatsthis>
        </entry>
        <entry key="DisplayIconsNText" type="Enum" >
            <choices>
                <choice name="DisplayIconsAndText">
                    <label>Never</label>
                </choice>
                <choice name="DisplayTextOnly">
                    <label>When Taskbar Full</label>
                </choice>
                <choice name="DisplayIconsOnly">
                    <label>Always</label>
                </choice>
            </choices>
            <default>DisplayIconsAndText</default>
            <label>Display:</label>
            <whatsthis>Choose taskbar display mode among <strong>Icons and text</strong>, <strong>Text only</strong> and <strong>Icons only</strong></whatsthis>
        </entry>
        <entry key="GroupTasks" type="Enum" >
            <choices>
                <choice name="GroupNever">
                    <label>Never</label>
                </choice>
                <choice name="GroupWhenFull">
                    <label>When Taskbar Full</label>
                </choice>
                <choice name="GroupAlways">
                    <label>Always</label>
                </choice>
            </choices>
            <default>GroupWhenFull</default>
            <label>Group similar tasks:</label>
            <whatsthis>The taskbar can group similar windows into single buttons. When one of these window group buttons are clicked on a menu appears showing all the windows in that group. This can be especially useful with the <em>Show all windows</em> option. You can set the taskbar to <strong>Never</strong> group windows, to <strong>Always</strong> group windows or to group windows only <strong>When the Taskbar is Full</strong>. By default the taskbar groups windows when it is full.</whatsthis>
        </entry>
        <entry key="ShowTaskStates" type="Enum" >
            <choices>
                <choice name="ShowAll">
                    <label>Any</label>
                </choice>
                <choice name="ShowStopped">
                    <label>Only Stopped</label>
                </choice>
                <choice name="ShowRunning">
                    <label>Only Running</label>
                </choice>
            </choices>
	    <default>ShowAll</default>
            <label>Show tasks with state:</label>
	    <whatsthis>The taskbar can show and/or hide tasks based on their current process state. Select <em>Any</em> to show all tasks regardless of current state.</whatsthis>
        </entry>
        <entry key="SortByDesktop" type="Bool" >
            <default>true</default>
            <label>Sort windows by desktop</label>
            <whatsthis>Selecting this option causes the taskbar to show windows in order of the desktop they appear on. By default this option is selected.</whatsthis>
        </entry>
        <entry key="SortByApp" type="Bool" >
            <default>true</default>
            <label>Sort windows by application</label>
            <whatsthis>Selecting this option causes the taskbar to show windows ordered by application. By default this option is selected.</whatsthis>
        </entry>
        <entry key="MaximumButtonWidth" type="Int" >
            <default>200</default>
            <min>0</min>
            <label></label>
            <whatsthis></whatsthis>
        </entry>
        <entry key="MinimumButtonHeight" type="Int" >
            <default>18</default>
            <label></label>
            <min>1</min>
            <whatsthis></whatsthis>
        </entry>
        <entry key="ShowCurrentScreenOnly" type="Bool" >
            <default>false</default>
            <label>Show windows from all screens</label>
            <whatsthis>Turning this option off will cause the taskbar to display <b>only</b> windows which are on the same Xinerama screen as the taskbar. By default, this option is selected and all windows are shown.</whatsthis>
        </entry>
        <entry key="taskbarFont" type="Font" >
            <default></default>
            <label></label>
            <whatsthis></whatsthis>
        </entry>
        <entry key="ShowWindowListBtn" type="Bool" >
            <default>false</default>
            <label>Show window list button</label>
            <whatsthis>Selecting this option causes the taskbar to display a button that, when clicked, shows a list of all windows in a popup menu.</whatsthis>
        </entry>
        <entry key="$(Button)Action" type="Enum" >
            <parameter name="Button" type="Enum">
                <values>
                    <value>LeftButton</value>
                    <value>MiddleButton</value>
                    <value>RightButton</value>
                </values>
            </parameter>
            <choices>
                <choice name="ShowTaskList">
                    <label>Show Task List</label>
                </choice>
                <choice name="ShowOperationsMenu">
                    <label>Show Operations Menu</label>
                </choice>
                <choice name="ActivateRaiseOrMinimize">
                    <label>Activate, Raise or Minimize Task</label>
                </choice>
                 <choice name="Activate">
                    <label>Activate Task</label>
                </choice>
                <choice name="Raise">
                    <label>Raise Task</label>
                </choice>
                <choice name="Lower">
                    <label>Lower Task</label>
                </choice>
                <choice name="Minimize">
                    <label>Minimize Task</label>
                </choice>
                <choice name="ToCurrentDesktop">
                    <label>Move To Current Desktop</label>
                </choice>
                <choice name="Close">
                    <label>Close Task</label>
                </choice>
            </choices>
            <default param="LeftButton">ShowTaskList</default>
            <default param="MiddleButton">ActivateRaiseOrMinimize</default>
            <default param="RightButton">ShowOperationsMenu</default>
            <label>Mouse button actions</label>
            <whatsthis></whatsthis>
        </entry>
    </group>

    <group name="Appearance">
        <entry key="AttentionBlinkIterations" type="Int">
            <default>4</default>
            <label>The number of times to blink a taskbar button when a window asks for attention. Setting this to 1000 or greater causes the button to blink forever.</label>
            <min>0</min>
        </entry>
        <entry key="DrawButtons" type="Bool" >
            <default>false</default>
            <label>Draw taskbar entries "flat" and not as a button</label>
            <whatsthis>Turning this option on will cause the taskbar to draw visible button frames for each entry in the taskbar. By default, this option is off.</whatsthis>
        </entry>
        <entry key="HaloText" type="Bool" >
            <default>false</default>
            <label>Draw taskbar text with a halo around it</label>
            <whatsthis>Turning this option on will cause the taskbar to draw fancier text that has an outline around it. While this is useful for transparent panels or particularly dark panel backgrounds, it is slower.</whatsthis>
        </entry>
        <entry key="ShowButtonOnHover" type="Bool" >
            <default>true</default>
            <label>Show a visible button frame on the task the cursor is positioned over</label>
        </entry>
        <entry key="ShowThumbnails" type="Bool" >
            <default>false</default>
            <label>Show thumbnails instead of icons in the mouse-over effects</label>
            <whatsthis>Enabling this option will draw a thumbnail of the window in its mouse-over effect.<p>If a window is minimized or resides on a different desktop while the taskbar is starting, an icon is shown until the window is restored or the appropriate desktop is activated, respectively.</p></whatsthis>
        </entry>
        <entry key="ThumbnailMaxDimension" type="UInt" >
            <default>100</default>
            <label>Maximum width/height of the thumbnail in pixels</label>
            <whatsthis>A thumbnail is created by resizing the window. The scaling factor is determined by its largest dimension and this value. In doing so, the thumbnail's size will not exceed this value in any dimension.</whatsthis>
        </entry>
        <entry key="UseCustomColors" type="Bool" >
            <default>false</default>
            <label>Use custom colors for taskbar buttons text and background</label>
            <whatsthis>Turning this option on will allow choosing your own colors for taskbar buttons text and background.</whatsthis>
        </entry>
        <entry name="ActiveTaskTextColor" type="Color" >
            <label>Color to use for active task button text</label>
            <default code="true">QColor()</default>
            <whatsthis>This color is used for displaying text on taskbar button for task which is active at the moment.</whatsthis>
        </entry>
        <entry name="InactiveTaskTextColor" type="Color" >
            <label>Color to use for inactive tasks button text</label>
            <default code="true">QColor()</default>
            <whatsthis>This color is used for displaying text on taskbar button for tasks other than active.</whatsthis>
        </entry>
        <entry name="TaskBackgroundColor" type="Color" >
            <label>Color to use for taskbar buttons background</label>
            <default code="true">QColor()</default>
            <whatsthis>This color is used for displaying background of taskbar buttons.</whatsthis>
        </entry>
    </group>
</kcfg>