~inkscape.dev/inkscape-devlibs/devlibs-gtk3

<a class="link" href="GtkSettings.html" title="Settings"><span class="returnvalue">GtkSettings</span></a> * <a class="link" href="GtkSettings.html#gtk-settings-get-default" title="gtk_settings_get_default ()">gtk_settings_get_default</a> (<em class="parameter"><code><span class="type">void</span></code></em>);

<a class="link" href="GtkSettings.html" title="Settings"><span class="returnvalue">GtkSettings</span></a> * <a class="link" href="GtkSettings.html#gtk-settings-get-for-screen" title="gtk_settings_get_for_screen ()">gtk_settings_get_for_screen</a> (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-install-property" title="gtk_settings_install_property ()">gtk_settings_install_property</a> (<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-install-property-parser" title="gtk_settings_install_property_parser ()">gtk_settings_install_property_parser</a>

(<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code><a class="link" href="GtkStyle.html#GtkRcPropertyParser" title="GtkRcPropertyParser ()"><span class="type">GtkRcPropertyParser</span></a> parser</code></em>);

<span class="returnvalue">gboolean</span> <a class="link" href="GtkSettings.html#gtk-rc-property-parse-color" title="gtk_rc_property_parse_color ()">gtk_rc_property_parse_color</a> (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);

<span class="returnvalue">gboolean</span> <a class="link" href="GtkSettings.html#gtk-rc-property-parse-enum" title="gtk_rc_property_parse_enum ()">gtk_rc_property_parse_enum</a> (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);

<span class="returnvalue">gboolean</span> <a class="link" href="GtkSettings.html#gtk-rc-property-parse-flags" title="gtk_rc_property_parse_flags ()">gtk_rc_property_parse_flags</a> (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);

<span class="returnvalue">gboolean</span> <a class="link" href="GtkSettings.html#gtk-rc-property-parse-requisition" title="gtk_rc_property_parse_requisition ()">gtk_rc_property_parse_requisition</a> (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);

<span class="returnvalue">gboolean</span> <a class="link" href="GtkSettings.html#gtk-rc-property-parse-border" title="gtk_rc_property_parse_border ()">gtk_rc_property_parse_border</a> (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-set-property-value" title="gtk_settings_set_property_value ()">gtk_settings_set_property_value</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

<em class="parameter"><code>const <a class="link" href="GtkSettings.html#GtkSettingsValue" title="struct GtkSettingsValue"><span class="type">GtkSettingsValue</span></a> *svalue</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-set-string-property" title="gtk_settings_set_string_property ()">gtk_settings_set_string_property</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *v_string</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-set-long-property" title="gtk_settings_set_long_property ()">gtk_settings_set_long_property</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

<em class="parameter"><code><span class="type">glong</span> v_long</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);

<span class="returnvalue">void</span> <a class="link" href="GtkSettings.html#gtk-settings-set-double-property" title="gtk_settings_set_double_property ()">gtk_settings_set_double_property</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

<em class="parameter"><code><span class="type">gdouble</span> v_double</code></em>,

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);

</pre>

</div>

<a name="GtkSettings.object-hierarchy"></a><h2>Object Hierarchy</h2>

GObject

+----GtkSettings

</pre>

</div>

<a name="GtkSettings.properties"></a><h2>Properties</h2>

"<a class="link" href="GtkSettings.html#GtkSettings--color-hash" title='The "color-hash" property'>color-hash</a>" <span class="type">GHashTable</span>* : Read

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order" title='The "gtk-alternative-button-order" property'>gtk-alternative-button-order</a>" <span class="type">gboolean</span> : Read / Write

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-sort-arrows" title='The "gtk-alternative-sort-arrows" property'>gtk-alternative-sort-arrows</a>" <span class="type">gboolean</span> : Read / Write

100

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-auto-mnemonics" title='The "gtk-auto-mnemonics" property'>gtk-auto-mnemonics</a>" <span class="type">gboolean</span> : Read / Write

101

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-button-images" title='The "gtk-button-images" property'>gtk-button-images</a>" <span class="type">gboolean</span> : Read / Write

102

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-can-change-accels" title='The "gtk-can-change-accels" property'>gtk-can-change-accels</a>" <span class="type">gboolean</span> : Read / Write

103

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-color-palette" title='The "gtk-color-palette" property'>gtk-color-palette</a>" <span class="type">gchar</span>* : Read / Write

104

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-color-scheme" title='The "gtk-color-scheme" property'>gtk-color-scheme</a>" <span class="type">gchar</span>* : Read / Write

105

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-blink" title='The "gtk-cursor-blink" property'>gtk-cursor-blink</a>" <span class="type">gboolean</span> : Read / Write

106

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-blink-time" title='The "gtk-cursor-blink-time" property'>gtk-cursor-blink-time</a>" <span class="type">gint</span> : Read / Write

107

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-blink-timeout" title='The "gtk-cursor-blink-timeout" property'>gtk-cursor-blink-timeout</a>" <span class="type">gint</span> : Read / Write

108

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-theme-name" title='The "gtk-cursor-theme-name" property'>gtk-cursor-theme-name</a>" <span class="type">gchar</span>* : Read / Write

109

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-theme-size" title='The "gtk-cursor-theme-size" property'>gtk-cursor-theme-size</a>" <span class="type">gint</span> : Read / Write

110

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-dnd-drag-threshold" title='The "gtk-dnd-drag-threshold" property'>gtk-dnd-drag-threshold</a>" <span class="type">gint</span> : Read / Write

111

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-double-click-distance" title='The "gtk-double-click-distance" property'>gtk-double-click-distance</a>" <span class="type">gint</span> : Read / Write

112

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-double-click-time" title='The "gtk-double-click-time" property'>gtk-double-click-time</a>" <span class="type">gint</span> : Read / Write

113

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-accels" title='The "gtk-enable-accels" property'>gtk-enable-accels</a>" <span class="type">gboolean</span> : Read / Write

114

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-animations" title='The "gtk-enable-animations" property'>gtk-enable-animations</a>" <span class="type">gboolean</span> : Read / Write

115

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-event-sounds" title='The "gtk-enable-event-sounds" property'>gtk-enable-event-sounds</a>" <span class="type">gboolean</span> : Read / Write

116

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-input-feedback-sounds" title='The "gtk-enable-input-feedback-sounds" property'>gtk-enable-input-feedback-sounds</a>" <span class="type">gboolean</span> : Read / Write

117

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-mnemonics" title='The "gtk-enable-mnemonics" property'>gtk-enable-mnemonics</a>" <span class="type">gboolean</span> : Read / Write

118

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-tooltips" title='The "gtk-enable-tooltips" property'>gtk-enable-tooltips</a>" <span class="type">gboolean</span> : Read / Write

119

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-entry-password-hint-timeout" title='The "gtk-entry-password-hint-timeout" property'>gtk-entry-password-hint-timeout</a>" <span class="type">guint</span> : Read / Write

120

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-entry-select-on-focus" title='The "gtk-entry-select-on-focus" property'>gtk-entry-select-on-focus</a>" <span class="type">gboolean</span> : Read / Write

121

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-error-bell" title='The "gtk-error-bell" property'>gtk-error-bell</a>" <span class="type">gboolean</span> : Read / Write

122

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-fallback-icon-theme" title='The "gtk-fallback-icon-theme" property'>gtk-fallback-icon-theme</a>" <span class="type">gchar</span>* : Read / Write

123

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-file-chooser-backend" title='The "gtk-file-chooser-backend" property'>gtk-file-chooser-backend</a>" <span class="type">gchar</span>* : Read / Write

124

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-font-name" title='The "gtk-font-name" property'>gtk-font-name</a>" <span class="type">gchar</span>* : Read / Write

125

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-fontconfig-timestamp" title='The "gtk-fontconfig-timestamp" property'>gtk-fontconfig-timestamp</a>" <span class="type">guint</span> : Read / Write

126

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-icon-sizes" title='The "gtk-icon-sizes" property'>gtk-icon-sizes</a>" <span class="type">gchar</span>* : Read / Write

127

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-icon-theme-name" title='The "gtk-icon-theme-name" property'>gtk-icon-theme-name</a>" <span class="type">gchar</span>* : Read / Write

128

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-im-module" title='The "gtk-im-module" property'>gtk-im-module</a>" <span class="type">gchar</span>* : Read / Write

129

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-key-theme-name" title='The "gtk-key-theme-name" property'>gtk-key-theme-name</a>" <span class="type">gchar</span>* : Read / Write

130

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-keynav-cursor-only" title='The "gtk-keynav-cursor-only" property'>gtk-keynav-cursor-only</a>" <span class="type">gboolean</span> : Read / Write

131

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-keynav-wrap-around" title='The "gtk-keynav-wrap-around" property'>gtk-keynav-wrap-around</a>" <span class="type">gboolean</span> : Read / Write

132

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-label-select-on-focus" title='The "gtk-label-select-on-focus" property'>gtk-label-select-on-focus</a>" <span class="type">gboolean</span> : Read / Write

133

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-bar-accel" title='The "gtk-menu-bar-accel" property'>gtk-menu-bar-accel</a>" <span class="type">gchar</span>* : Read / Write

134

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-bar-popup-delay" title='The "gtk-menu-bar-popup-delay" property'>gtk-menu-bar-popup-delay</a>" <span class="type">gint</span> : Read / Write

135

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title='The "gtk-menu-images" property'>gtk-menu-images</a>" <span class="type">gboolean</span> : Read / Write

136

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-popdown-delay" title='The "gtk-menu-popdown-delay" property'>gtk-menu-popdown-delay</a>" <span class="type">gint</span> : Read / Write

137

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-popup-delay" title='The "gtk-menu-popup-delay" property'>gtk-menu-popup-delay</a>" <span class="type">gint</span> : Read / Write

138

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-modules" title='The "gtk-modules" property'>gtk-modules</a>" <span class="type">gchar</span>* : Read / Write

139

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-primary-button-warps-slider" title='The "gtk-primary-button-warps-slider" property'>gtk-primary-button-warps-slider</a>" <span class="type">gboolean</span> : Read / Write

140

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-print-backends" title='The "gtk-print-backends" property'>gtk-print-backends</a>" <span class="type">gchar</span>* : Read / Write

141

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-print-preview-command" title='The "gtk-print-preview-command" property'>gtk-print-preview-command</a>" <span class="type">gchar</span>* : Read / Write

142

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-recent-files-limit" title='The "gtk-recent-files-limit" property'>gtk-recent-files-limit</a>" <span class="type">gint</span> : Read / Write

143

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-recent-files-max-age" title='The "gtk-recent-files-max-age" property'>gtk-recent-files-max-age</a>" <span class="type">gint</span> : Read / Write

144

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-scrolled-window-placement" title='The "gtk-scrolled-window-placement" property'>gtk-scrolled-window-placement</a>" <a class="link" href="gtk2-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a> : Read / Write

145

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-show-input-method-menu" title='The "gtk-show-input-method-menu" property'>gtk-show-input-method-menu</a>" <span class="type">gboolean</span> : Read / Write

146

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-show-unicode-menu" title='The "gtk-show-unicode-menu" property'>gtk-show-unicode-menu</a>" <span class="type">gboolean</span> : Read / Write

147

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-sound-theme-name" title='The "gtk-sound-theme-name" property'>gtk-sound-theme-name</a>" <span class="type">gchar</span>* : Read / Write

148

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-split-cursor" title='The "gtk-split-cursor" property'>gtk-split-cursor</a>" <span class="type">gboolean</span> : Read / Write

149

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-theme-name" title='The "gtk-theme-name" property'>gtk-theme-name</a>" <span class="type">gchar</span>* : Read / Write

150

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-timeout-expand" title='The "gtk-timeout-expand" property'>gtk-timeout-expand</a>" <span class="type">gint</span> : Read / Write

151

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-timeout-initial" title='The "gtk-timeout-initial" property'>gtk-timeout-initial</a>" <span class="type">gint</span> : Read / Write

152

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-timeout-repeat" title='The "gtk-timeout-repeat" property'>gtk-timeout-repeat</a>" <span class="type">gint</span> : Read / Write

153

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-toolbar-icon-size" title='The "gtk-toolbar-icon-size" property'>gtk-toolbar-icon-size</a>" <a class="link" href="gtk2-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> : Read / Write

154

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-toolbar-style" title='The "gtk-toolbar-style" property'>gtk-toolbar-style</a>" <a class="link" href="gtk2-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> : Read / Write

155

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-mode-timeout" title='The "gtk-tooltip-browse-mode-timeout" property'>gtk-tooltip-browse-mode-timeout</a>" <span class="type">gint</span> : Read / Write

156

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-timeout" title='The "gtk-tooltip-browse-timeout" property'>gtk-tooltip-browse-timeout</a>" <span class="type">gint</span> : Read / Write

157

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-timeout" title='The "gtk-tooltip-timeout" property'>gtk-tooltip-timeout</a>" <span class="type">gint</span> : Read / Write

158

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-touchscreen-mode" title='The "gtk-touchscreen-mode" property'>gtk-touchscreen-mode</a>" <span class="type">gboolean</span> : Read / Write

159

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-xft-antialias" title='The "gtk-xft-antialias" property'>gtk-xft-antialias</a>" <span class="type">gint</span> : Read / Write

160

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-xft-dpi" title='The "gtk-xft-dpi" property'>gtk-xft-dpi</a>" <span class="type">gint</span> : Read / Write

161

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-xft-hinting" title='The "gtk-xft-hinting" property'>gtk-xft-hinting</a>" <span class="type">gint</span> : Read / Write

162

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-xft-hintstyle" title='The "gtk-xft-hintstyle" property'>gtk-xft-hintstyle</a>" <span class="type">gchar</span>* : Read / Write

163

"<a class="link" href="GtkSettings.html#GtkSettings--gtk-xft-rgba" title='The "gtk-xft-rgba" property'>gtk-xft-rgba</a>" <span class="type">gchar</span>* : Read / Write

164

</pre>

165

</div>

166

167

<a name="GtkSettings.description"></a><h2>Description</h2>

168

<p>

169

GtkSettings provide a mechanism to share global settings between applications.

170

On the X window system, this sharing is realized by an <a class="ulink" href="" target="_top">XSettings</a>

171

manager that is usually part of the desktop environment, along with utilities

172

that let the user change these settings. In the absence of an Xsettings manager,

173

settings can also be specified in RC files.

174

</p>

175

<p>

176

Applications can override system-wide settings with <a class="link" href="GtkSettings.html#gtk-settings-set-string-property" title="gtk_settings_set_string_property ()"><code class="function">gtk_settings_set_string_property()</code></a>,

177

<a class="link" href="GtkSettings.html#gtk-settings-set-long-property" title="gtk_settings_set_long_property ()"><code class="function">gtk_settings_set_long_property()</code></a>, etc. This should be restricted to special

178

cases though; GtkSettings are not meant as an application configuration

179

facility. When doing so, you need to be aware that settings that are specific

180

to individual widgets may not be available before the widget type has been

181

realized at least once. The following example demonstrates a way to do this:

182

</p>

183

184

185

<tbody>

186

<tr>

187

<td class="listing_lines" align="right"><pre>1

188

189

190

4</pre></td>

191

192

<span class="comment">/* make sure the type is realized */</span>

193

<span class="function">g_type_class_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="function">g_type_class_ref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GTK_TYPE_IMAGE_MENU_ITEM</span><span class="symbol">));</span>

194

<span class="function">g_object_set</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkSettings.html#gtk-settings-get-default">gtk_settings_get_default</a></span><span class="normal"> </span><span class="symbol">(),</span><span class="normal"> </span><span class="string">"gtk-menu-images"</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>

195

</tr>

196

</tbody>

197

</table>

198

</div>

199

200

<p>

201

</p>

202

<p>

203

There is one GtkSettings instance per screen. It can be obtained with

204

<a class="link" href="GtkSettings.html#gtk-settings-get-for-screen" title="gtk_settings_get_for_screen ()"><code class="function">gtk_settings_get_for_screen()</code></a>, but in many cases, it is more convenient

205

to use <a class="link" href="GtkWidget.html#gtk-widget-get-settings" title="gtk_widget_get_settings ()"><code class="function">gtk_widget_get_settings()</code></a>. <a class="link" href="GtkSettings.html#gtk-settings-get-default" title="gtk_settings_get_default ()"><code class="function">gtk_settings_get_default()</code></a> returns the

206

GtkSettings instance for the default screen.

207

</p>

208

</div>

209

210

<a name="GtkSettings.details"></a><h2>Details</h2>

211

212

<a name="GtkSettings-struct"></a><h3>GtkSettings</h3>

213

<pre class="programlisting">typedef struct _GtkSettings GtkSettings;</pre>

214

<p>

215

</p>

216

</div>

217

<hr>

218

219

<a name="GtkSettingsValue"></a><h3>struct GtkSettingsValue</h3>

220

<pre class="programlisting">struct GtkSettingsValue {

221

/* origin should be something like "filename:linenumber" for rc files,

222

* or e.g. "XProperty" for other sources

223

224

gchar *origin;

225

226

/* valid types are LONG, DOUBLE and STRING corresponding to the token parsed,

227

* or a GSTRING holding an unparsed statement

228

229

GValue value;

230

};

231

</pre>

232

<p>

233

</p>

234

</div>

235

<hr>

236

237

<a name="gtk-settings-get-default"></a><h3>gtk_settings_get_default ()</h3>

238

<pre class="programlisting"><a class="link" href="GtkSettings.html" title="Settings"><span class="returnvalue">GtkSettings</span></a> * gtk_settings_get_default (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>

239

<p>

240

Gets the <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object for the default GDK screen, creating

241

it if necessary. See <a class="link" href="GtkSettings.html#gtk-settings-get-for-screen" title="gtk_settings_get_for_screen ()"><code class="function">gtk_settings_get_for_screen()</code></a>.

242

</p>

243

244

245

246

<col>

247

</colgroup>

248

249

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

250

<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object. If there is no default

251

screen, then returns <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>

252

</td>

253

</tr></tbody>

254

</table></div>

255

</div>

256

<hr>

257

258

<a name="gtk-settings-get-for-screen"></a><h3>gtk_settings_get_for_screen ()</h3>

259

<pre class="programlisting"><a class="link" href="GtkSettings.html" title="Settings"><span class="returnvalue">GtkSettings</span></a> * gtk_settings_get_for_screen (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>

260

<p>

261

Gets the <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object for <em class="parameter"><code>screen</code></em>, creating it if necessary.

262

</p>

263

264

265

266

<col>

267

</colgroup>

268

<tbody>

269

<tr>

270

<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>

271

<td>a <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a>.</td>

272

</tr>

273

<tr>

274

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

275

<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>

276

</td>

277

</tr>

278

</tbody>

279

</table></div>

280

<p class="since">Since 2.2</p>

281

</div>

282

<hr>

283

284

<a name="gtk-settings-install-property"></a><h3>gtk_settings_install_property ()</h3>

285

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_install_property (<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>

286

<p>

287

</p>

288

</div>

289

<hr>

290

291

<a name="gtk-settings-install-property-parser"></a><h3>gtk_settings_install_property_parser ()</h3>

292

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_install_property_parser

293

(<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>,

294

<em class="parameter"><code><a class="link" href="GtkStyle.html#GtkRcPropertyParser" title="GtkRcPropertyParser ()"><span class="type">GtkRcPropertyParser</span></a> parser</code></em>);</pre>

295

<p>

296

</p>

297

</div>

298

<hr>

299

300

<a name="gtk-rc-property-parse-color"></a><h3>gtk_rc_property_parse_color ()</h3>

301

<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_rc_property_parse_color (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

302

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

303

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);</pre>

304

<p>

305

A <a class="link" href="GtkStyle.html#GtkRcPropertyParser" title="GtkRcPropertyParser ()"><span class="type">GtkRcPropertyParser</span></a> for use with <a class="link" href="GtkSettings.html#gtk-settings-install-property-parser" title="gtk_settings_install_property_parser ()"><code class="function">gtk_settings_install_property_parser()</code></a>

306

or <a class="link" href="GtkWidget.html#gtk-widget-class-install-style-property-parser" title="gtk_widget_class_install_style_property_parser ()"><code class="function">gtk_widget_class_install_style_property_parser()</code></a> which parses a

307

color given either by its name or in the form

308

<code class="literal">{ red, green, blue }</code> where <code class="literal">red</code>, <code class="literal">green</code> and

309

<code class="literal">blue</code> are integers between 0 and 65535 or floating-point numbers

310

between 0 and 1.

311

</p>

312

313

314

315

<col>

316

</colgroup>

317

<tbody>

318

<tr>

319

<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>

320

<td>a <span class="type">GParamSpec</span>

321

</td>

322

</tr>

323

<tr>

324

<td><p><span class="term"><em class="parameter"><code>gstring</code></em> :</span></p></td>

325

<td>the <span class="type">GString</span> to be parsed</td>

326

</tr>

327

<tr>

328

<td><p><span class="term"><em class="parameter"><code>property_value</code></em> :</span></p></td>

329

<td>a <span class="type">GValue</span> which must hold <a href="../gdk2/gdk2-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> values.</td>

330

</tr>

331

<tr>

332

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

333

<td>

334

<code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em> could be parsed and <em class="parameter"><code>property_value</code></em>

335

has been set to the resulting <a href="../gdk2/gdk2-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</td>

336

</tr>

337

</tbody>

338

</table></div>

339

</div>

340

<hr>

341

342

<a name="gtk-rc-property-parse-enum"></a><h3>gtk_rc_property_parse_enum ()</h3>

343

<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_rc_property_parse_enum (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

344

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

345

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);</pre>

346

<p>

347

348

349

enumeration value.

350

</p>

351

<p>

352

The enumeration value can be specified by its name, its nickname or

353

its numeric value. For consistency with flags parsing, the value

354

may be surrounded by parentheses.

355

</p>

356

357

358

359

<col>

360

</colgroup>

361

<tbody>

362

<tr>

363

<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>

364

<td>a <span class="type">GParamSpec</span>

365

</td>

366

</tr>

367

<tr>

368

<td><p><span class="term"><em class="parameter"><code>gstring</code></em> :</span></p></td>

369

<td>the <span class="type">GString</span> to be parsed</td>

370

</tr>

371

<tr>

372

<td><p><span class="term"><em class="parameter"><code>property_value</code></em> :</span></p></td>

373

<td>a <span class="type">GValue</span> which must hold enum values.</td>

374

</tr>

375

<tr>

376

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

377

<td>

378

<code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em> could be parsed and <em class="parameter"><code>property_value</code></em>

379

has been set to the resulting <span class="type">GEnumValue</span>.</td>

380

</tr>

381

</tbody>

382

</table></div>

383

</div>

384

<hr>

385

386

<a name="gtk-rc-property-parse-flags"></a><h3>gtk_rc_property_parse_flags ()</h3>

387

<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_rc_property_parse_flags (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

388

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

389

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);</pre>

390

<p>

391

392

393

</p>

394

<p>

395

Flags can be specified by their name, their nickname or

396

numerically. Multiple flags can be specified in the form

397

<code class="literal">"( flag1 | flag2 | ... )"</code>.

398

</p>

399

400

401

402

<col>

403

</colgroup>

404

<tbody>

405

<tr>

406

<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>

407

<td>a <span class="type">GParamSpec</span>

408

</td>

409

</tr>

410

<tr>

411

<td><p><span class="term"><em class="parameter"><code>gstring</code></em> :</span></p></td>

412

<td>the <span class="type">GString</span> to be parsed</td>

413

</tr>

414

<tr>

415

<td><p><span class="term"><em class="parameter"><code>property_value</code></em> :</span></p></td>

416

<td>a <span class="type">GValue</span> which must hold flags values.</td>

417

</tr>

418

<tr>

419

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

420

<td>

421

<code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em> could be parsed and <em class="parameter"><code>property_value</code></em>

422

has been set to the resulting flags value.</td>

423

</tr>

424

</tbody>

425

</table></div>

426

</div>

427

<hr>

428

429

<a name="gtk-rc-property-parse-requisition"></a><h3>gtk_rc_property_parse_requisition ()</h3>

430

<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_rc_property_parse_requisition (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

431

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

432

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);</pre>

433

<p>

434

435

436

requisition in the form

437

<code class="literal">"{ width, height }"</code> for integers <code class="literal">width</code> and <code class="literal">height</code>.

438

</p>

439

440

441

442

<col>

443

</colgroup>

444

<tbody>

445

<tr>

446

<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>

447

<td>a <span class="type">GParamSpec</span>

448

</td>

449

</tr>

450

<tr>

451

<td><p><span class="term"><em class="parameter"><code>gstring</code></em> :</span></p></td>

452

<td>the <span class="type">GString</span> to be parsed</td>

453

</tr>

454

<tr>

455

<td><p><span class="term"><em class="parameter"><code>property_value</code></em> :</span></p></td>

456

<td>a <span class="type">GValue</span> which must hold boxed values.</td>

457

</tr>

458

<tr>

459

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

460

<td>

461

<code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em> could be parsed and <em class="parameter"><code>property_value</code></em>

462

has been set to the resulting <a class="link" href="GtkWidget.html#GtkRequisition"><span class="type">GtkRequisition</span></a>.</td>

463

</tr>

464

</tbody>

465

</table></div>

466

</div>

467

<hr>

468

469

<a name="gtk-rc-property-parse-border"></a><h3>gtk_rc_property_parse_border ()</h3>

470

<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_rc_property_parse_border (<em class="parameter"><code>const <span class="type">GParamSpec</span> *pspec</code></em>,

471

<em class="parameter"><code>const <span class="type">GString</span> *gstring</code></em>,

472

<em class="parameter"><code><span class="type">GValue</span> *property_value</code></em>);</pre>

473

<p>

474

475

476

borders in the form

477

<code class="literal">"{ left, right, top, bottom }"</code> for integers

478

<code class="literal">left</code>, <code class="literal">right</code>, <code class="literal">top</code> and <code class="literal">bottom</code>.

479

</p>

480

481

482

483

<col>

484

</colgroup>

485

<tbody>

486

<tr>

487

<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>

488

<td>a <span class="type">GParamSpec</span>

489

</td>

490

</tr>

491

<tr>

492

<td><p><span class="term"><em class="parameter"><code>gstring</code></em> :</span></p></td>

493

<td>the <span class="type">GString</span> to be parsed</td>

494

</tr>

495

<tr>

496

<td><p><span class="term"><em class="parameter"><code>property_value</code></em> :</span></p></td>

497

<td>a <span class="type">GValue</span> which must hold boxed values.</td>

498

</tr>

499

<tr>

500

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

501

<td>

502

<code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em> could be parsed and <em class="parameter"><code>property_value</code></em>

503

has been set to the resulting <a class="link" href="GtkStyle.html#GtkBorder"><span class="type">GtkBorder</span></a>.</td>

504

</tr>

505

</tbody>

506

</table></div>

507

</div>

508

<hr>

509

510

<a name="gtk-settings-set-property-value"></a><h3>gtk_settings_set_property_value ()</h3>

511

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_set_property_value (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

512

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

513

<em class="parameter"><code>const <a class="link" href="GtkSettings.html#GtkSettingsValue" title="struct GtkSettingsValue"><span class="type">GtkSettingsValue</span></a> *svalue</code></em>);</pre>

514

<p>

515

</p>

516

</div>

517

<hr>

518

519

<a name="gtk-settings-set-string-property"></a><h3>gtk_settings_set_string_property ()</h3>

520

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_set_string_property (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

521

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

522

<em class="parameter"><code>const <span class="type">gchar</span> *v_string</code></em>,

523

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);</pre>

524

<p>

525

</p>

526

</div>

527

<hr>

528

529

<a name="gtk-settings-set-long-property"></a><h3>gtk_settings_set_long_property ()</h3>

530

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_set_long_property (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

531

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

532

<em class="parameter"><code><span class="type">glong</span> v_long</code></em>,

533

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);</pre>

534

<p>

535

</p>

536

</div>

537

<hr>

538

539

<a name="gtk-settings-set-double-property"></a><h3>gtk_settings_set_double_property ()</h3>

540

<pre class="programlisting"><span class="returnvalue">void</span> gtk_settings_set_double_property (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,

541

<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,

542

<em class="parameter"><code><span class="type">gdouble</span> v_double</code></em>,

543

<em class="parameter"><code>const <span class="type">gchar</span> *origin</code></em>);</pre>

544

<p>

545

</p>

546

</div>

547

</div>

548

549

<a name="GtkSettings.property-details"></a><h2>Property Details</h2>

550

551

<a name="GtkSettings--color-hash"></a><h3>The <code class="literal">"color-hash"</code> property</h3>

552

<pre class="programlisting"> "color-hash" <span class="type">GHashTable</span>* : Read</pre>

553

<p>

554

Holds a hash table representation of the <a class="link" href="GtkSettings.html#GtkSettings--gtk-color-scheme" title='The "gtk-color-scheme" property'><span class="type">"gtk-color-scheme"</span></a>

555

setting, mapping color names to <a href="../gdk2/gdk2-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a>s.

556

</p>

557

<p class="since">Since 2.10</p>

558

</div>

559

<hr>

560

561

<a name="GtkSettings--gtk-alternative-button-order"></a><h3>The <code class="literal">"gtk-alternative-button-order"</code> property</h3>

562

<pre class="programlisting"> "gtk-alternative-button-order" <span class="type">gboolean</span> : Read / Write</pre>

563

<p>Whether buttons in dialogs should use the alternative button order.</p>

564

<p>Default value: FALSE</p>

565

</div>

566

<hr>

567

568

<a name="GtkSettings--gtk-alternative-sort-arrows"></a><h3>The <code class="literal">"gtk-alternative-sort-arrows"</code> property</h3>

569

<pre class="programlisting"> "gtk-alternative-sort-arrows" <span class="type">gboolean</span> : Read / Write</pre>

570

<p>

571

Controls the direction of the sort indicators in sorted list and tree

572

views. By default an arrow pointing down means the column is sorted

573

in ascending order. When set to <code class="literal">TRUE</code>, this order will be inverted.

574

</p>

575

<p>Default value: FALSE</p>

576

<p class="since">Since 2.12</p>

577

</div>

578

<hr>

579

580

<a name="GtkSettings--gtk-auto-mnemonics"></a><h3>The <code class="literal">"gtk-auto-mnemonics"</code> property</h3>

581

<pre class="programlisting"> "gtk-auto-mnemonics" <span class="type">gboolean</span> : Read / Write</pre>

582

<p>

583

Whether mnemonics should be automatically shown and hidden when the user

584

presses the mnemonic activator.

585

</p>

586

<p>Default value: FALSE</p>

587

<p class="since">Since 2.20</p>

588

</div>

589

<hr>

590

591

<a name="GtkSettings--gtk-button-images"></a><h3>The <code class="literal">"gtk-button-images"</code> property</h3>

592

<pre class="programlisting"> "gtk-button-images" <span class="type">gboolean</span> : Read / Write</pre>

593

<p>Whether images should be shown on buttons.</p>

594

<p>Default value: TRUE</p>

595

</div>

596

<hr>

597

598

<a name="GtkSettings--gtk-can-change-accels"></a><h3>The <code class="literal">"gtk-can-change-accels"</code> property</h3>

599

<pre class="programlisting"> "gtk-can-change-accels" <span class="type">gboolean</span> : Read / Write</pre>

600

<p>Whether menu accelerators can be changed by pressing a key over the menu item.</p>

601

<p>Default value: FALSE</p>

602

</div>

603

<hr>

604

605

<a name="GtkSettings--gtk-color-palette"></a><h3>The <code class="literal">"gtk-color-palette"</code> property</h3>

606

<pre class="programlisting"> "gtk-color-palette" <span class="type">gchar</span>* : Read / Write</pre>

607

<p>Palette to use in the color selector.</p>

608

<p>Default value: "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"</p>

609

</div>

610

<hr>

611

612

<a name="GtkSettings--gtk-color-scheme"></a><h3>The <code class="literal">"gtk-color-scheme"</code> property</h3>

613

<pre class="programlisting"> "gtk-color-scheme" <span class="type">gchar</span>* : Read / Write</pre>

614

<p>

615

A palette of named colors for use in themes. The format of the string is

616

</p>

617

618

name1: color1

619

name2: color2

620

...

621

</pre>

622

<p>

623

Color names must be acceptable as identifiers in the

624

gtkrc syntax, and

625

color specifications must be in the format accepted by

626

<a href="../gdk2/gdk2-Colormaps-and-Colors.html#gdk-color-parse"><code class="function">gdk_color_parse()</code></a>.

627

</p>

628

<p>

629

Note that due to the way the color tables from different sources are

630

merged, color specifications will be converted to hexadecimal form

631

when getting this property.

632

</p>

633

<p>

634

Starting with GTK+ 2.12, the entries can alternatively be separated

635

by ';' instead of newlines:

636

</p>

637

638

name1: color1; name2: color2; ...

639

</pre>

640

<p>

641

</p>

642

<p>Default value: ""</p>

643

<p class="since">Since 2.10</p>

644

</div>

645

<hr>

646

647

<a name="GtkSettings--gtk-cursor-blink"></a><h3>The <code class="literal">"gtk-cursor-blink"</code> property</h3>

648

<pre class="programlisting"> "gtk-cursor-blink" <span class="type">gboolean</span> : Read / Write</pre>

649

<p>

650

Whether the cursor should blink.

651

</p>

652

<p>

653

Also see the <a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-blink-timeout" title='The "gtk-cursor-blink-timeout" property'><span class="type">"gtk-cursor-blink-timeout"</span></a> setting,

654

which allows more flexible control over cursor blinking.

655

</p>

656

<p>Default value: TRUE</p>

657

</div>

658

<hr>

659

660

<a name="GtkSettings--gtk-cursor-blink-time"></a><h3>The <code class="literal">"gtk-cursor-blink-time"</code> property</h3>

661

<pre class="programlisting"> "gtk-cursor-blink-time" <span class="type">gint</span> : Read / Write</pre>

662

<p>Length of the cursor blink cycle, in milliseconds.</p>

663

<p>Allowed values: >= 100</p>

664

<p>Default value: 1200</p>

665

</div>

666

<hr>

667

668

<a name="GtkSettings--gtk-cursor-blink-timeout"></a><h3>The <code class="literal">"gtk-cursor-blink-timeout"</code> property</h3>

669

<pre class="programlisting"> "gtk-cursor-blink-timeout" <span class="type">gint</span> : Read / Write</pre>

670

<p>

671

Time after which the cursor stops blinking, in seconds.

672

The timer is reset after each user interaction.

673

</p>

674

<p>

675

Setting this to zero has the same effect as setting

676

<a class="link" href="GtkSettings.html#GtkSettings--gtk-cursor-blink" title='The "gtk-cursor-blink" property'><span class="type">"gtk-cursor-blink"</span></a> to <code class="literal">FALSE</code>.

677

</p>

678

<p>Allowed values: >= 1</p>

679

<p>Default value: 2147483647</p>

680

<p class="since">Since 2.12</p>

681

</div>

682

<hr>

683

684

<a name="GtkSettings--gtk-cursor-theme-name"></a><h3>The <code class="literal">"gtk-cursor-theme-name"</code> property</h3>

685

<pre class="programlisting"> "gtk-cursor-theme-name" <span class="type">gchar</span>* : Read / Write</pre>

686

<p>Name of the cursor theme to use, or NULL to use the default theme.</p>

687

<p>Default value: NULL</p>

688

</div>

689

<hr>

690

691

<a name="GtkSettings--gtk-cursor-theme-size"></a><h3>The <code class="literal">"gtk-cursor-theme-size"</code> property</h3>

692

<pre class="programlisting"> "gtk-cursor-theme-size" <span class="type">gint</span> : Read / Write</pre>

693

<p>Size to use for cursors, or 0 to use the default size.</p>

694

<p>Allowed values: [0,128]</p>

695

<p>Default value: 0</p>

696

</div>

697

<hr>

698

699

<a name="GtkSettings--gtk-dnd-drag-threshold"></a><h3>The <code class="literal">"gtk-dnd-drag-threshold"</code> property</h3>

700

<pre class="programlisting"> "gtk-dnd-drag-threshold" <span class="type">gint</span> : Read / Write</pre>

701

<p>Number of pixels the cursor can move before dragging.</p>

702

<p>Allowed values: >= 1</p>

703

<p>Default value: 8</p>

704

</div>

705

<hr>

706

707

<a name="GtkSettings--gtk-double-click-distance"></a><h3>The <code class="literal">"gtk-double-click-distance"</code> property</h3>

708

<pre class="programlisting"> "gtk-double-click-distance" <span class="type">gint</span> : Read / Write</pre>

709

<p>Maximum distance allowed between two clicks for them to be considered a double click (in pixels).</p>

710

<p>Allowed values: >= 0</p>

711

<p>Default value: 5</p>

712

</div>

713

<hr>

714

715

<a name="GtkSettings--gtk-double-click-time"></a><h3>The <code class="literal">"gtk-double-click-time"</code> property</h3>

716

<pre class="programlisting"> "gtk-double-click-time" <span class="type">gint</span> : Read / Write</pre>

717

<p>Maximum time allowed between two clicks for them to be considered a double click (in milliseconds).</p>

718

<p>Allowed values: >= 0</p>

719

<p>Default value: 250</p>

720

</div>

721

<hr>

722

723

<a name="GtkSettings--gtk-enable-accels"></a><h3>The <code class="literal">"gtk-enable-accels"</code> property</h3>

724

<pre class="programlisting"> "gtk-enable-accels" <span class="type">gboolean</span> : Read / Write</pre>

725

<p>

726

Whether menu items should have visible accelerators which can be

727

activated.

728

</p>

729

<p>Default value: TRUE</p>

730

<p class="since">Since 2.12</p>

731

</div>

732

<hr>

733

734

<a name="GtkSettings--gtk-enable-animations"></a><h3>The <code class="literal">"gtk-enable-animations"</code> property</h3>

735

<pre class="programlisting"> "gtk-enable-animations" <span class="type">gboolean</span> : Read / Write</pre>

736

<p>Whether to enable toolkit-wide animations.</p>

737

<p>Default value: TRUE</p>

738

</div>

739

<hr>

740

741

<a name="GtkSettings--gtk-enable-event-sounds"></a><h3>The <code class="literal">"gtk-enable-event-sounds"</code> property</h3>

742

<pre class="programlisting"> "gtk-enable-event-sounds" <span class="type">gboolean</span> : Read / Write</pre>

743

<p>

744

Whether to play any event sounds at all.

745

</p>

746

<p>

747

See the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec" target="_top">Sound Theme spec</a>

748

for more information on event sounds and sound themes.

749

</p>

750

<p>

751

GTK+ itself does not support event sounds, you have to use a loadable

752

module like the one that comes with libcanberra.

753

</p>

754

<p>Default value: TRUE</p>

755

<p class="since">Since 2.14</p>

756

</div>

757

<hr>

758

759

<a name="GtkSettings--gtk-enable-input-feedback-sounds"></a><h3>The <code class="literal">"gtk-enable-input-feedback-sounds"</code> property</h3>

760

<pre class="programlisting"> "gtk-enable-input-feedback-sounds" <span class="type">gboolean</span> : Read / Write</pre>

761

<p>

762

Whether to play event sounds as feedback to user input.

763

</p>

764

<p>

765

See the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec" target="_top">Sound Theme spec</a>

766

for more information on event sounds and sound themes.

767

</p>

768

<p>

769

GTK+ itself does not support event sounds, you have to use a loadable

770

module like the one that comes with libcanberra.

771

</p>

772

<p>Default value: TRUE</p>

773

<p class="since">Since 2.14</p>

774

</div>

775

<hr>

776

777

<a name="GtkSettings--gtk-enable-mnemonics"></a><h3>The <code class="literal">"gtk-enable-mnemonics"</code> property</h3>

778

<pre class="programlisting"> "gtk-enable-mnemonics" <span class="type">gboolean</span> : Read / Write</pre>

779

<p>

780

Whether labels and menu items should have visible mnemonics which

781

can be activated.

782

</p>

783

<p>Default value: TRUE</p>

784

<p class="since">Since 2.12</p>

785

</div>

786

<hr>

787

788

<a name="GtkSettings--gtk-enable-tooltips"></a><h3>The <code class="literal">"gtk-enable-tooltips"</code> property</h3>

789

<pre class="programlisting"> "gtk-enable-tooltips" <span class="type">gboolean</span> : Read / Write</pre>

790

<p>

791

Whether tooltips should be shown on widgets.

792

</p>

793

<p>Default value: TRUE</p>

794

<p class="since">Since 2.14</p>

795

</div>

796

<hr>

797

798

<a name="GtkSettings--gtk-entry-password-hint-timeout"></a><h3>The <code class="literal">"gtk-entry-password-hint-timeout"</code> property</h3>

799

<pre class="programlisting"> "gtk-entry-password-hint-timeout" <span class="type">guint</span> : Read / Write</pre>

800

<p>

801

How long to show the last input character in hidden

802

entries. This value is in milliseconds. 0 disables showing the

803

last char. 600 is a good value for enabling it.

804

</p>

805

<p>Default value: 0</p>

806

<p class="since">Since 2.10</p>

807

</div>

808

<hr>

809

810

<a name="GtkSettings--gtk-entry-select-on-focus"></a><h3>The <code class="literal">"gtk-entry-select-on-focus"</code> property</h3>

811

<pre class="programlisting"> "gtk-entry-select-on-focus" <span class="type">gboolean</span> : Read / Write</pre>

812

<p>Whether to select the contents of an entry when it is focused.</p>

813

<p>Default value: TRUE</p>

814

</div>

815

<hr>

816

817

<a name="GtkSettings--gtk-error-bell"></a><h3>The <code class="literal">"gtk-error-bell"</code> property</h3>

818

<pre class="programlisting"> "gtk-error-bell" <span class="type">gboolean</span> : Read / Write</pre>

819

<p>

820

When <code class="literal">TRUE</code>, keyboard navigation and other input-related errors

821

will cause a beep. Since the error bell is implemented using

822

<a href="../gdk2/gdk2-Windows.html#gdk-window-beep"><code class="function">gdk_window_beep()</code></a>, the windowing system may offer ways to

823

configure the error bell in many ways, such as flashing the

824

window or similar visual effects.

825

</p>

826

<p>Default value: TRUE</p>

827

<p class="since">Since 2.12</p>

828

</div>

829

<hr>

830

831

<a name="GtkSettings--gtk-fallback-icon-theme"></a><h3>The <code class="literal">"gtk-fallback-icon-theme"</code> property</h3>

832

<pre class="programlisting"> "gtk-fallback-icon-theme" <span class="type">gchar</span>* : Read / Write</pre>

833

<p>Name of a icon theme to fall back to.</p>

834

<p>Default value: NULL</p>

835

</div>

836

<hr>

837

838

<a name="GtkSettings--gtk-file-chooser-backend"></a><h3>The <code class="literal">"gtk-file-chooser-backend"</code> property</h3>

839

<pre class="programlisting"> "gtk-file-chooser-backend" <span class="type">gchar</span>* : Read / Write</pre>

840

<p>Name of the GtkFileChooser backend to use by default.</p>

841

<p>Default value: NULL</p>

842

</div>

843

<hr>

844

845

<a name="GtkSettings--gtk-font-name"></a><h3>The <code class="literal">"gtk-font-name"</code> property</h3>

846

<pre class="programlisting"> "gtk-font-name" <span class="type">gchar</span>* : Read / Write</pre>

847

<p>Name of default font to use.</p>

848

<p>Default value: "Sans 10"</p>

849

</div>

850

<hr>

851

852

<a name="GtkSettings--gtk-fontconfig-timestamp"></a><h3>The <code class="literal">"gtk-fontconfig-timestamp"</code> property</h3>

853

<pre class="programlisting"> "gtk-fontconfig-timestamp" <span class="type">guint</span> : Read / Write</pre>

854

<p>Timestamp of current fontconfig configuration.</p>

855

<p>Default value: 0</p>

856

</div>

857

<hr>

858

859

<a name="GtkSettings--gtk-icon-sizes"></a><h3>The <code class="literal">"gtk-icon-sizes"</code> property</h3>

860

<pre class="programlisting"> "gtk-icon-sizes" <span class="type">gchar</span>* : Read / Write</pre>

861

<p>

862

A list of icon sizes. The list is separated by colons, and

863

item has the form:

864

</p>

865

<p>

866

<em class="replaceable"><code>size-name</code></em> = <em class="replaceable"><code>width</code></em> , <em class="replaceable"><code>height</code></em>

867

</p>

868

<p>

869

E.g. "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48".

870

GTK+ itself use the following named icon sizes: gtk-menu,

871

gtk-button, gtk-small-toolbar, gtk-large-toolbar, gtk-dnd,

872

gtk-dialog. Applications can register their own named icon

873

sizes with <a class="link" href="gtk2-Themeable-Stock-Images.html#gtk-icon-size-register" title="gtk_icon_size_register ()"><code class="function">gtk_icon_size_register()</code></a>.

874

</p>

875

<p>Default value: NULL</p>

876

</div>

877

<hr>

878

879

<a name="GtkSettings--gtk-icon-theme-name"></a><h3>The <code class="literal">"gtk-icon-theme-name"</code> property</h3>

880

<pre class="programlisting"> "gtk-icon-theme-name" <span class="type">gchar</span>* : Read / Write</pre>

881

<p>Name of icon theme to use.</p>

882

<p>Default value: "hicolor"</p>

883

</div>

884

<hr>

885

886

<a name="GtkSettings--gtk-im-module"></a><h3>The <code class="literal">"gtk-im-module"</code> property</h3>

887

<pre class="programlisting"> "gtk-im-module" <span class="type">gchar</span>* : Read / Write</pre>

888

<p>

889

Which IM (input method) module should be used by default. This is the

890

input method that will be used if the user has not explicitly chosen

891

another input method from the IM context menu.

892

This also can be a colon-separated list of input methods, which GTK+

893

will try in turn until it finds one available on the system.

894

</p>

895

<p>

896

See <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a> and see the <a class="link" href="GtkSettings.html#GtkSettings--gtk-show-input-method-menu" title='The "gtk-show-input-method-menu" property'><span class="type">"gtk-show-input-method-menu"</span></a> property.

897

</p>

898

<p>Default value: NULL</p>

899

</div>

900

<hr>

901

902

<a name="GtkSettings--gtk-key-theme-name"></a><h3>The <code class="literal">"gtk-key-theme-name"</code> property</h3>

903

<pre class="programlisting"> "gtk-key-theme-name" <span class="type">gchar</span>* : Read / Write</pre>

904

<p>Name of key theme RC file to load.</p>

905

<p>Default value: NULL</p>

906

</div>

907

<hr>

908

909

<a name="GtkSettings--gtk-keynav-cursor-only"></a><h3>The <code class="literal">"gtk-keynav-cursor-only"</code> property</h3>

910

<pre class="programlisting"> "gtk-keynav-cursor-only" <span class="type">gboolean</span> : Read / Write</pre>

911

<p>

912

When <code class="literal">TRUE</code>, keyboard navigation should be able to reach all widgets

913

by using the cursor keys only. Tab, Shift etc. keys can't be expected

914

to be present on the used input device.

915

</p>

916

<p>Default value: FALSE</p>

917

<p class="since">Since 2.12</p>

918

</div>

919

<hr>

920

921

<a name="GtkSettings--gtk-keynav-wrap-around"></a><h3>The <code class="literal">"gtk-keynav-wrap-around"</code> property</h3>

922

<pre class="programlisting"> "gtk-keynav-wrap-around" <span class="type">gboolean</span> : Read / Write</pre>

923

<p>

924

When <code class="literal">TRUE</code>, some widgets will wrap around when doing keyboard

925

navigation, such as menus, menubars and notebooks.

926

</p>

927

<p>Default value: TRUE</p>

928

<p class="since">Since 2.12</p>

929

</div>

930

<hr>

931

932

<a name="GtkSettings--gtk-label-select-on-focus"></a><h3>The <code class="literal">"gtk-label-select-on-focus"</code> property</h3>

933

<pre class="programlisting"> "gtk-label-select-on-focus" <span class="type">gboolean</span> : Read / Write</pre>

934

<p>Whether to select the contents of a selectable label when it is focused.</p>

935

<p>Default value: TRUE</p>

936

</div>

937

<hr>

938

939

<a name="GtkSettings--gtk-menu-bar-accel"></a><h3>The <code class="literal">"gtk-menu-bar-accel"</code> property</h3>

940

<pre class="programlisting"> "gtk-menu-bar-accel" <span class="type">gchar</span>* : Read / Write</pre>

941

<p>Keybinding to activate the menu bar.</p>

942

<p>Default value: "F10"</p>

943

</div>

944

<hr>

945

946

<a name="GtkSettings--gtk-menu-bar-popup-delay"></a><h3>The <code class="literal">"gtk-menu-bar-popup-delay"</code> property</h3>

947

<pre class="programlisting"> "gtk-menu-bar-popup-delay" <span class="type">gint</span> : Read / Write</pre>

948

<p>Delay before the submenus of a menu bar appear.</p>

949

<p>Allowed values: >= 0</p>

950

<p>Default value: 0</p>

951

</div>

952

<hr>

953

954

<a name="GtkSettings--gtk-menu-images"></a><h3>The <code class="literal">"gtk-menu-images"</code> property</h3>

955

<pre class="programlisting"> "gtk-menu-images" <span class="type">gboolean</span> : Read / Write</pre>

956

<p>Whether images should be shown in menus.</p>

957

<p>Default value: TRUE</p>

958

</div>

959

<hr>

960

961

<a name="GtkSettings--gtk-menu-popdown-delay"></a><h3>The <code class="literal">"gtk-menu-popdown-delay"</code> property</h3>

962

<pre class="programlisting"> "gtk-menu-popdown-delay" <span class="type">gint</span> : Read / Write</pre>

963

<p>The time before hiding a submenu when the pointer is moving towards the submenu.</p>

964

<p>Allowed values: >= 0</p>

965

<p>Default value: 1000</p>

966

</div>

967

<hr>

968

969

<a name="GtkSettings--gtk-menu-popup-delay"></a><h3>The <code class="literal">"gtk-menu-popup-delay"</code> property</h3>

970

<pre class="programlisting"> "gtk-menu-popup-delay" <span class="type">gint</span> : Read / Write</pre>

971

<p>Minimum time the pointer must stay over a menu item before the submenu appear.</p>

972

<p>Allowed values: >= 0</p>

973

<p>Default value: 225</p>

974

</div>

975

<hr>

976

977

<a name="GtkSettings--gtk-modules"></a><h3>The <code class="literal">"gtk-modules"</code> property</h3>

978

<pre class="programlisting"> "gtk-modules" <span class="type">gchar</span>* : Read / Write</pre>

979

<p>List of currently active GTK modules.</p>

980

<p>Default value: NULL</p>

981

</div>

982

<hr>

983

984

<a name="GtkSettings--gtk-primary-button-warps-slider"></a><h3>The <code class="literal">"gtk-primary-button-warps-slider"</code> property</h3>

985

<pre class="programlisting"> "gtk-primary-button-warps-slider" <span class="type">gboolean</span> : Read / Write</pre>

986

<p>Whether a primary click on the trough should warp the slider into position.</p>

987

<p>Default value: FALSE</p>

988

<p class="since">Since 2.24</p>

989

</div>

990

<hr>

991

992

<a name="GtkSettings--gtk-print-backends"></a><h3>The <code class="literal">"gtk-print-backends"</code> property</h3>

993

<pre class="programlisting"> "gtk-print-backends" <span class="type">gchar</span>* : Read / Write</pre>

994

<p>

995

A comma-separated list of print backends to use in the print

996

dialog. Available print backends depend on the GTK+ installation,

997

and may include "file", "cups", "lpr" or "papi".

998

</p>

999

<p>Default value: "file,cups"</p>

1000

<p class="since">Since 2.10</p>

1001

</div>

1002

<hr>

1003

1004

<a name="GtkSettings--gtk-print-preview-command"></a><h3>The <code class="literal">"gtk-print-preview-command"</code> property</h3>

1005

<pre class="programlisting"> "gtk-print-preview-command" <span class="type">gchar</span>* : Read / Write</pre>

1006

<p>

1007

A command to run for displaying the print preview. The command

1008

should contain a <code class="literal">f</code> placeholder, which will get replaced by

1009

the path to the pdf file. The command may also contain a <code class="literal">s</code>

1010

placeholder, which will get replaced by the path to a file

1011

containing the print settings in the format produced by

1012

<a class="link" href="GtkPrintSettings.html#gtk-print-settings-to-file" title="gtk_print_settings_to_file ()"><code class="function">gtk_print_settings_to_file()</code></a>.

1013

</p>

1014

<p>

1015

The preview application is responsible for removing the pdf file

1016

and the print settings file when it is done.

1017

</p>

1018

<p>Default value: "evince --unlink-tempfile --preview --print-settings %s %f"</p>

1019

<p class="since">Since 2.10</p>

1020

</div>

1021

<hr>

1022

1023

<a name="GtkSettings--gtk-recent-files-limit"></a><h3>The <code class="literal">"gtk-recent-files-limit"</code> property</h3>

1024

<pre class="programlisting"> "gtk-recent-files-limit" <span class="type">gint</span> : Read / Write</pre>

1025

<p>

1026

The number of recently used files that should be displayed by default by

1027

<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> implementations and by the <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. A value of

1028

-1 means every recently used file stored.

1029

</p>

1030

<p>Allowed values: >= G_MAXULONG</p>

1031

<p>Default value: 50</p>

1032

<p class="since">Since 2.12</p>

1033

</div>

1034

<hr>

1035

1036

<a name="GtkSettings--gtk-recent-files-max-age"></a><h3>The <code class="literal">"gtk-recent-files-max-age"</code> property</h3>

1037

<pre class="programlisting"> "gtk-recent-files-max-age" <span class="type">gint</span> : Read / Write</pre>

1038

<p>

1039

The maximum age, in days, of the items inside the recently used

1040

resources list. Items older than this setting will be excised

1041

from the list. If set to 0, the list will always be empty; if

1042

set to -1, no item will be removed.

1043

</p>

1044

<p>Allowed values: >= G_MAXULONG</p>

1045

<p>Default value: 30</p>

1046

<p class="since">Since 2.14</p>

1047

</div>

1048

<hr>

1049

1050

<a name="GtkSettings--gtk-scrolled-window-placement"></a><h3>The <code class="literal">"gtk-scrolled-window-placement"</code> property</h3>

1051

<pre class="programlisting"> "gtk-scrolled-window-placement" <a class="link" href="gtk2-Standard-Enumerations.html#GtkCornerType" title="enum GtkCornerType"><span class="type">GtkCornerType</span></a> : Read / Write</pre>

1052

<p>

1053

Where the contents of scrolled windows are located with respect to the

1054

scrollbars, if not overridden by the scrolled window's own placement.

1055

</p>

1056

<p>Default value: GTK_CORNER_TOP_LEFT</p>

1057

<p class="since">Since 2.10</p>

1058

</div>

1059

<hr>

1060

1061

<a name="GtkSettings--gtk-show-input-method-menu"></a><h3>The <code class="literal">"gtk-show-input-method-menu"</code> property</h3>

1062

<pre class="programlisting"> "gtk-show-input-method-menu" <span class="type">gboolean</span> : Read / Write</pre>

1063

<p>Whether the context menus of entries and text views should offer to change the input method.</p>

1064

<p>Default value: TRUE</p>

1065

</div>

1066

<hr>

1067

1068

<a name="GtkSettings--gtk-show-unicode-menu"></a><h3>The <code class="literal">"gtk-show-unicode-menu"</code> property</h3>

1069

<pre class="programlisting"> "gtk-show-unicode-menu" <span class="type">gboolean</span> : Read / Write</pre>

1070

<p>Whether the context menus of entries and text views should offer to insert control characters.</p>

1071

<p>Default value: TRUE</p>

1072

</div>

1073

<hr>

1074

1075

<a name="GtkSettings--gtk-sound-theme-name"></a><h3>The <code class="literal">"gtk-sound-theme-name"</code> property</h3>

1076

<pre class="programlisting"> "gtk-sound-theme-name" <span class="type">gchar</span>* : Read / Write</pre>

1077

<p>

1078

The XDG sound theme to use for event sounds.

1079

</p>

1080

<p>

1081

See the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec" target="_top">Sound Theme spec</a>

1082

for more information on event sounds and sound themes.

1083

</p>

1084

<p>

1085

GTK+ itself does not support event sounds, you have to use a loadable

1086

module like the one that comes with libcanberra.

1087

</p>

1088

<p>Default value: "freedesktop"</p>

1089

<p class="since">Since 2.14</p>

1090

</div>

1091

<hr>

1092

1093

<a name="GtkSettings--gtk-split-cursor"></a><h3>The <code class="literal">"gtk-split-cursor"</code> property</h3>

1094

<pre class="programlisting"> "gtk-split-cursor" <span class="type">gboolean</span> : Read / Write</pre>

1095

<p>Whether two cursors should be displayed for mixed left-to-right and right-to-left text.</p>

1096

<p>Default value: TRUE</p>

1097

</div>

1098

<hr>

1099

1100

<a name="GtkSettings--gtk-theme-name"></a><h3>The <code class="literal">"gtk-theme-name"</code> property</h3>

1101

<pre class="programlisting"> "gtk-theme-name" <span class="type">gchar</span>* : Read / Write</pre>

1102

<p>Name of theme RC file to load.</p>

1103

<p>Default value: "Raleigh"</p>

1104

</div>

1105

<hr>

1106

1107

<a name="GtkSettings--gtk-timeout-expand"></a><h3>The <code class="literal">"gtk-timeout-expand"</code> property</h3>

1108

<pre class="programlisting"> "gtk-timeout-expand" <span class="type">gint</span> : Read / Write</pre>

1109

<p>Expand value for timeouts, when a widget is expanding a new region.</p>

1110

<p>Allowed values: >= 0</p>

1111

<p>Default value: 500</p>

1112

</div>

1113

<hr>

1114

1115

<a name="GtkSettings--gtk-timeout-initial"></a><h3>The <code class="literal">"gtk-timeout-initial"</code> property</h3>

1116

<pre class="programlisting"> "gtk-timeout-initial" <span class="type">gint</span> : Read / Write</pre>

1117

<p>Starting value for timeouts, when button is pressed.</p>

1118

<p>Allowed values: >= 0</p>

1119

<p>Default value: 200</p>

1120

</div>

1121

<hr>

1122

1123

<a name="GtkSettings--gtk-timeout-repeat"></a><h3>The <code class="literal">"gtk-timeout-repeat"</code> property</h3>

1124

<pre class="programlisting"> "gtk-timeout-repeat" <span class="type">gint</span> : Read / Write</pre>

1125

<p>Repeat value for timeouts, when button is pressed.</p>

1126

<p>Allowed values: >= 0</p>

1127

<p>Default value: 20</p>

1128

</div>

1129

<hr>

1130

1131

<a name="GtkSettings--gtk-toolbar-icon-size"></a><h3>The <code class="literal">"gtk-toolbar-icon-size"</code> property</h3>

1132

<pre class="programlisting"> "gtk-toolbar-icon-size" <a class="link" href="gtk2-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> : Read / Write</pre>

1133

<p>The size of icons in default toolbars.</p>

1134

<p>Default value: GTK_ICON_SIZE_LARGE_TOOLBAR</p>

1135

</div>

1136

<hr>

1137

1138

<a name="GtkSettings--gtk-toolbar-style"></a><h3>The <code class="literal">"gtk-toolbar-style"</code> property</h3>

1139

<pre class="programlisting"> "gtk-toolbar-style" <a class="link" href="gtk2-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> : Read / Write</pre>

1140

<p>Whether default toolbars have text only, text and icons, icons only, etc.</p>

1141

<p>Default value: GTK_TOOLBAR_BOTH</p>

1142

</div>

1143

<hr>

1144

1145

<a name="GtkSettings--gtk-tooltip-browse-mode-timeout"></a><h3>The <code class="literal">"gtk-tooltip-browse-mode-timeout"</code> property</h3>

1146

<pre class="programlisting"> "gtk-tooltip-browse-mode-timeout" <span class="type">gint</span> : Read / Write</pre>

1147

<p>

1148

Amount of time, in milliseconds, after which the browse mode

1149

will be disabled.

1150

</p>

1151

<p>

1152

See <a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-timeout" title='The "gtk-tooltip-browse-timeout" property'><span class="type">"gtk-tooltip-browse-timeout"</span></a> for more information

1153

about browse mode.

1154

</p>

1155

<p>Allowed values: >= 0</p>

1156

<p>Default value: 500</p>

1157

<p class="since">Since 2.12</p>

1158

</div>

1159

<hr>

1160

1161

<a name="GtkSettings--gtk-tooltip-browse-timeout"></a><h3>The <code class="literal">"gtk-tooltip-browse-timeout"</code> property</h3>

1162

<pre class="programlisting"> "gtk-tooltip-browse-timeout" <span class="type">gint</span> : Read / Write</pre>

1163

<p>

1164

Controls the time after which tooltips will appear when

1165

browse mode is enabled, in milliseconds.

1166

</p>

1167

<p>

1168

Browse mode is enabled when the mouse pointer moves off an object

1169

where a tooltip was currently being displayed. If the mouse pointer

1170

hits another object before the browse mode timeout expires (see

1171

<a class="link" href="GtkSettings.html#GtkSettings--gtk-tooltip-browse-mode-timeout" title='The "gtk-tooltip-browse-mode-timeout" property'><span class="type">"gtk-tooltip-browse-mode-timeout"</span></a>), it will take the

1172

amount of milliseconds specified by this setting to popup the tooltip

1173

for the new object.

1174

</p>

1175

<p>Allowed values: >= 0</p>

1176

<p>Default value: 60</p>

1177

<p class="since">Since 2.12</p>

1178

</div>

1179

<hr>

1180

1181

<a name="GtkSettings--gtk-tooltip-timeout"></a><h3>The <code class="literal">"gtk-tooltip-timeout"</code> property</h3>

1182

<pre class="programlisting"> "gtk-tooltip-timeout" <span class="type">gint</span> : Read / Write</pre>

1183

<p>

1184

Time, in milliseconds, after which a tooltip could appear if the

1185

cursor is hovering on top of a widget.

1186

</p>

1187

<p>Allowed values: >= 0</p>

1188

<p>Default value: 500</p>

1189

<p class="since">Since 2.12</p>

1190

</div>

1191

<hr>

1192

1193

<a name="GtkSettings--gtk-touchscreen-mode"></a><h3>The <code class="literal">"gtk-touchscreen-mode"</code> property</h3>

1194

<pre class="programlisting"> "gtk-touchscreen-mode" <span class="type">gboolean</span> : Read / Write</pre>

1195

<p>

1196

When <code class="literal">TRUE</code>, there are no motion notify events delivered on this screen,

1197

and widgets can't use the pointer hovering them for any essential

1198

functionality.

1199

</p>

1200

<p>Default value: FALSE</p>

1201

<p class="since">Since 2.10</p>

1202

</div>

1203

<hr>

1204

1205

<a name="GtkSettings--gtk-xft-antialias"></a><h3>The <code class="literal">"gtk-xft-antialias"</code> property</h3>

1206

<pre class="programlisting"> "gtk-xft-antialias" <span class="type">gint</span> : Read / Write</pre>

1207

<p>Whether to antialias Xft fonts; 0=no, 1=yes, -1=default.</p>

1208

<p>Allowed values: [G_MAXULONG,1]</p>

1209

<p>Default value: -1</p>

1210

</div>

1211

<hr>

1212

1213

<a name="GtkSettings--gtk-xft-dpi"></a><h3>The <code class="literal">"gtk-xft-dpi"</code> property</h3>

1214

<pre class="programlisting"> "gtk-xft-dpi" <span class="type">gint</span> : Read / Write</pre>

1215

<p>Resolution for Xft, in 1024 * dots/inch. -1 to use default value.</p>

1216

<p>Allowed values: [G_MAXULONG,1048576]</p>

1217

<p>Default value: -1</p>

1218

</div>

1219

<hr>

1220

1221

<a name="GtkSettings--gtk-xft-hinting"></a><h3>The <code class="literal">"gtk-xft-hinting"</code> property</h3>

1222

<pre class="programlisting"> "gtk-xft-hinting" <span class="type">gint</span> : Read / Write</pre>

1223

<p>Whether to hint Xft fonts; 0=no, 1=yes, -1=default.</p>

1224

<p>Allowed values: [G_MAXULONG,1]</p>

1225

<p>Default value: -1</p>

1226

</div>

1227

<hr>

1228

1229

<a name="GtkSettings--gtk-xft-hintstyle"></a><h3>The <code class="literal">"gtk-xft-hintstyle"</code> property</h3>

1230

<pre class="programlisting"> "gtk-xft-hintstyle" <span class="type">gchar</span>* : Read / Write</pre>

1231

<p>What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull.</p>

1232

<p>Default value: NULL</p>

1233

</div>

1234

<hr>

1235

1236

<a name="GtkSettings--gtk-xft-rgba"></a><h3>The <code class="literal">"gtk-xft-rgba"</code> property</h3>

1237

<pre class="programlisting"> "gtk-xft-rgba" <span class="type">gchar</span>* : Read / Write</pre>

1238

<p>Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr.</p>

1239

<p>Default value: NULL</p>

1240

</div>

1241

</div>

1242

</div>

1243

1244

<hr>

1245

Generated by GTK-Doc V1.18</div>

1246

</body>

1247

</html>

b'\\ No newline at end of file'

Older »