3
<schema id="org.gnome.desktop.wm.preferences"
4
path="/org/gnome/desktop/wm/preferences/"
5
gettext-domain="@GETTEXT_PACKAGE@">
6
<key name="mouse-button-modifier" type="s">
7
<default><![CDATA['<Alt>']]></default>
8
<_summary>Modifier to use for modified window click actions</_summary>
10
Clicking a window while holding down this modifier key will move the
11
window (left click), resize the window (middle click), or show the
12
window menu (right click). The middle and right click operations may
13
be swapped using the "resize-with-right-button" key. Modifier is
14
expressed as <![CDATA["<Alt>"]]> or <![CDATA["<Super>"]]> for example.
17
<key name="resize-with-right-button" type="b">
18
<default>false</default>
19
<_summary>Whether to resize with the right button</_summary>
21
Set this to true to resize with the right button and show a menu with
22
the middle button while holding down the key given in
23
"mouse-button-modifier"; set it to false to make it work
24
the opposite way around.
27
<key name="button-layout" type="s">
28
<default>':minimize,maximize,close'</default>
29
<_summary>Arrangement of buttons on the titlebar</_summary>
31
Arrangement of buttons on the titlebar. The value should be a string,
32
such as "menu:minimize,maximize,spacer,close"; the colon separates
33
the left corner of the window from the right corner, and the button
34
names are comma-separated. Duplicate buttons are not allowed. Unknown
35
button names are silently ignored so that buttons can be added in
36
future metacity versions without breaking older versions. A special
37
spacer tag can be used to insert some space between
41
<key name="focus-mode" enum="org.gnome.desktop.GDesktopFocusMode">
42
<default>'click'</default>
43
<_summary>Window focus mode</_summary>
45
The window focus mode indicates how windows are activated. It has
46
three possible values; "click" means windows must be clicked in order
47
to focus them, "sloppy" means windows are focused when the mouse enters
48
the window, and "mouse" means windows are focused when the mouse enters
49
the window and unfocused when the mouse leaves the window.
52
<key name="focus-new-windows"
53
enum="org.gnome.desktop.GDesktopFocusNewWindows">
54
<default>'smart'</default>
55
<_summary>Control how new windows get focus</_summary>
57
This option provides additional control over how newly created windows
58
get focus. It has two possible values; "smart" applies the user's
59
normal focus mode, and "strict" results in windows started from a
60
terminal not being given focus.
63
<key name="raise-on-click" type="b">
64
<default>true</default>
66
Whether raising should be a side-effect of other user interactions
69
Setting this option to false can lead to buggy behavior, so users are
70
strongly discouraged from changing it from the default of true. Many
71
actions (e.g. clicking in the client area, moving or resizing the window)
72
normally raise the window as a side-effect. Setting this option to false,
73
which is strongly discouraged, will decouple raising from other user
74
actions, and ignore raise requests generated by applications.
75
See http://bugzilla.gnome.org/show_bug.cgi?id=445447#c6.
77
Even when this option is false, windows can still be raised by an
78
alt-left-click anywhere on the window, a normal click on the window
79
decorations, or by special messages from pagers, such as activation
80
requests from tasklist applets. This option is currently disabled
81
in click-to-focus mode. Note that the list of ways to raise windows
82
when raise-on-click is false does not include programmatic requests
83
from applications to raise windows; such requests will be ignored
84
regardless of the reason for the request.
86
If you are an application developer and have a user complaining that
87
your application does not work with this setting disabled, tell them
88
it is -their- fault for breaking their window manager and that they
89
need to change this option back to true or live with the "bug"
93
<key name="action-double-click-titlebar"
94
enum="org.gnome.desktop.GDesktopTitlebarAction">
95
<default>'toggle-maximize'</default>
96
<_summary>Action on title bar double-click</_summary>
98
This option determines the effects of double-clicking on the title bar.
100
Current valid options are 'toggle-shade', which will shade/unshade the
101
window, 'toggle-maximize' which will maximize/unmaximize the window,
102
'toggle-maximize-horizontally' and 'toggle-maximize-vertically'
103
which will maximize/unmaximize the window in that direction only,
104
'minimize' which will minimize the window, 'shade' which will roll
105
the window up, 'menu' which will display the window menu,
106
'lower' which will put the window behind all the others,
107
and 'none' which will not do anything.
109
<!-- For compatibility with GConf strings (Metacity 2.30) -->
111
<alias value="toggle_shade" target="toggle-shade"/>
112
<alias value="toggle_maximize" target="toggle-maximize"/>
113
<alias value="toggle_maximize_horizontally"
114
target="toggle-maximize-horizontally"/>
115
<alias value="toggle_maximize_vertically"
116
target="toggle-maximize-vertically"/>
119
<key name="action-middle-click-titlebar"
120
enum="org.gnome.desktop.GDesktopTitlebarAction">
121
<default>'lower'</default>
122
<_summary>Action on title bar middle-click</_summary>
124
This option determines the effects of middle-clicking on the title bar.
126
Current valid options are 'toggle-shade', which will shade/unshade
127
the window, 'toggle-maximize' which will maximize/unmaximize the window,
128
'toggle-maximize-horizontally' and 'toggle-maximize-vertically'
129
which will maximize/unmaximize the window in that direction only,
130
'minimize' which will minimize the window, 'shade' which will roll
131
the window up, 'menu' which will display the window menu,
132
'lower' which will put the window behind all the others,
133
and 'none' which will not do anything.
135
<!-- For compatibility with GConf strings (Metacity 2.30) -->
137
<alias value="toggle_shade" target="toggle-shade"/>
138
<alias value="toggle_maximize" target="toggle-maximize"/>
139
<alias value="toggle_maximize_horizontally"
140
target="toggle-maximize-horizontally"/>
141
<alias value="toggle_maximize_vertically"
142
target="toggle-maximize-vertically"/>
145
<key name="action-right-click-titlebar"
146
enum="org.gnome.desktop.GDesktopTitlebarAction">
147
<default>'menu'</default>
148
<_summary>Action on title bar right-click</_summary>
150
This option determines the effects of right-clicking on the title bar.
152
Current valid options are 'toggle-shade', which will shade/unshade
153
the window, 'toggle-maximize' which will maximize/unmaximize
154
the window, 'toggle-maximize-horizontally' and
155
'toggle-maximize-vertically' which will maximize/unmaximize
156
the window in that direction only, 'minimize' which will minimize
157
the window, 'shade' which will roll the window up,
158
'menu' which will display the window menu, 'lower' which will put
159
the window behind all the others, and 'none' which will not do anything.
161
<!-- For compatibility with GConf strings (Metacity 2.30) -->
163
<alias value="toggle_shade" target="toggle-shade"/>
164
<alias value="toggle_maximize" target="toggle-maximize"/>
165
<alias value="toggle_maximize_horizontally"
166
target="toggle-maximize-horizontally"/>
167
<alias value="toggle_maximize_vertically"
168
target="toggle-maximize-vertically"/>
171
<key name="auto-raise" type="b">
172
<default>false</default>
173
<_summary>Automatically raises the focused window</_summary>
175
If set to true, and the focus mode is either "sloppy" or "mouse"
176
then the focused window will be automatically raised after a delay
177
specified by the auto-raise-delay key. This is not related to clicking
178
on a window to raise it, nor to entering a window during drag-and-drop.
181
<key name="auto-raise-delay" type="i">
182
<range min="0" max="10000"/>
183
<default>500</default>
184
<_summary>Delay in milliseconds for the auto raise option</_summary>
186
The time delay before raising a window if auto-raise is set to true.
187
The delay is given in thousandths of a second.
190
<key name="theme" type="s">
191
<default>'Adwaita'</default>
192
<_summary>Current theme</_summary>
194
The theme determines the appearance of window borders, titlebar,
198
<key name="titlebar-uses-system-font" type="b">
199
<default>false</default>
200
<_summary>Use standard system font in window titles</_summary>
202
If true, ignore the titlebar-font option, and use the standard
203
application font for window titles.
206
<key name="titlebar-font" type="s">
207
<default>'Cantarell Bold 11'</default>
208
<_summary>Window title font</_summary>
210
A font description string describing a font for window titlebars.
211
The size from the description will only be used if the
212
titlebar-font-size option is set to 0. Also, this option is disabled
213
if the titlebar-uses-desktop-font option is set to true.
216
<key name="num-workspaces" type="i">
218
<range min="1" max="36"/>
219
<_summary>Number of workspaces</_summary>
221
Number of workspaces. Must be more than zero, and has a fixed maximum
222
to prevent making the desktop unusable by accidentally asking
223
for too many workspaces.
226
<key name="audible-bell" type="b">
227
<default>true</default>
228
<_summary>System Bell is Audible</_summary>
230
Determines whether applications or the system can generate audible
231
'beeps'; may be used in conjunction with 'visual bell'
232
to allow silent 'beeps'.
235
<key name="visual-bell" type="b">
236
<default>false</default>
237
<_summary>Enable Visual Bell</_summary>
239
Turns on a visual indication when an application or the system issues
240
a 'bell' or 'beep'; useful for the hard-of-hearing and for use
241
in noisy environments.
244
<key name="visual-bell-type"
245
enum="org.gnome.desktop.GDesktopVisualBellType">
246
<default>'fullscreen-flash'</default>
247
<_summary>Visual Bell Type</_summary>
249
Tells the WM how to implement the visual indication that the
250
system bell or another application 'bell' indicator has been rung.
252
Currently there are two valid values, "fullscreen-flash", which
253
causes a fullscreen white-black flash, and "frame-flash" which
254
causes the titlebar of the application which sent the bell signal
257
If the application which sent the bell is unknown (as is usually
258
the case for the default "system beep"), the currently focused
259
window's titlebar is flashed.
261
<!-- For compatibility with GConf strings (Metacity 2.30) -->
263
<alias value="fullscreen" target="fullscreen-flash"/>
264
<alias value="frame_flash" target="frame-flash"/>
267
<key name="application-based" type="b">
268
<default>false</default>
270
(Not implemented) Navigation works in terms of applications not windows
273
If true, then the WM works in terms of applications rather than
274
windows. The concept is a bit abstract, but in general an
275
application-based setup is more like the Mac and less like Windows.
276
When you focus a window in application-based mode, all the windows
277
in the application will be raised. Also, in application-based mode,
278
focus clicks are not passed through to windows in other applications.
279
Application-based mode is, however, largely unimplemented
283
<key name="disable-workarounds" type="b">
284
<default>false</default>
286
Disable misfeatures that are required by old or broken applications
289
Some applications disregard specifications in ways that result in
290
window manager misfeatures. This option puts the WM in a
291
rigorously correct mode, which gives a more consistent
292
user interface, provided one does not need to run any
293
misbehaving applications.
296
<key name="workspace-names" type="as">
297
<default>[]</default>
298
<_summary>The names of the workspaces</_summary>
300
Defines the names that should be assigned to workspaces.
301
If the list is too long for the current number of workspaces,
302
names in excess will be ignored. If the list is too short, or
303
includes empty names, missing values will be replaced with the
304
default ("Workspace N").