====== Xfce GTK Engine Theme how to ======
This document is under development
===== Introduction =====
gtk-xfce-engine, Xfce4's gtk engine provides a render engine for Gtk 2 and Gtk 3.
This page contains information about the extra theming settings the gtk-xfce-engine provides.
Both Gtk 2 and Gtk 3 are described here to make it easier to get a consistent look between them both.
===== Xfce engine properties =====
==== Gtk 2 ====
To use the xfce engine in Gtk 2 set the engine to xfce. In the engine block the style properties can be set.
The following simple properties are available.
| smooth_edge | boolean | FALSE | Draw smooth rounded edges |
| grip_style | none, rough, slide | rough | Draw style of the grips on sliders |
The block property boxfill can be used for gradient backgrounds.
Within the boxfill block the following properties can be set.
| fill_style | plain, gradient | plain | Draw style of the background |
| orientation | auto, vertical, horizontal, northern_diagonal, southern_diagonal | auto | The direction of the gradient background |
| shade_start | float | 1.10 | The shade of the background color to start the gradient with |
| shade_end | float | 0.90 | The shade of the background color to end the gradient with |
Example showing the default values.
style "default"
{
engine "xfce"
{
smooth_edge = false
grip_style = rough
boxfill
{
fill_style = plain
orientation = auto
shade_start = 1.10
shade_end = 0.90
}
}
}
==== Gtk 3 ====
To use the xfce engine in Gtk 3 set the engine to xfce. The style properties can be directly set using the -xfce prefix.
The following properties are available.
| -xfce-smooth-edge | boolean | FALSE | Draw smooth rounded edges |
| -xfce-grip-style | disabled, rough, slide | rough | Draw style of the grips on sliders |
Other properties can be set with default Gtk 3 settings. For example with background-image: -gtk-gradient() the background can be set to gradient.
Here is a list of some of the properties. See the GtkCssProvider documentation for more details.
| engine | GtkThemingEngine | The render engine to use. Set to xfce to use the gtk-xfce-engine |
| color | GdkColor | The foreground or text color |
| background-color | GdkColor | The background or base color |
| background-image | cairo_pattern_t | The pattern to draw the background. Either a -gtk-gradient of an url() |
| border-color | GdkColor | The border color. Set it to darker() from the background-color for compatibility with Gtk 2 |
| border-image | | Not supported by the xfce engine |
| border-width | GtkBorder | The width reserved for the border. The xfce engine will only use 2 pixels at most for the border |
| border-radius | | Not supported by the xfce engine |
| margin | GtkBorder | Margin to the widget content. Only a few widgets support this |
| padding | GtkBorder | Padding around the widget. Only a few widgets support this |
| text-shadow | GtkTextShadow | The text shadow. Set text-shadow: 1 1 white; for *:insensitive for compatibility with Gtk 2 |
==== Gtk compatibility ====
The simple Gtk 2 style properties can be directly converted. With one exception of grip_style none. The value none in css will set the property value to default which is rough and not disabled.
The boxfill property is replaced by background-image: -gtk-gradient(). By using the -gtk-gradient it is not possible to reproduce the northern_diagonal and southern_diagonal gradients. These are never or rarely used so the support is dropped until requested.
The auto orientation is not automatically supported and must be configured manually see the examples for more details.
The xthickness end ythickness are replaced by border-width. usages: border-width: ; border-width: ; border-width: ;
Linear vertical gradient example.
Gtk 2
style "default"
{
bg[ACTIVE] = "#cccccc"
bg[INSENSITIVE] = "#aaaaaa"
bg[NORMAL] = "#eeeeee"
bg[PRELIGHT] = "#ffffff"
bg[selected] = "#dddddd"
engine "xfce"
{
boxfill
{
fill_style = gradient
orientation = vertical
shade_start = 1.10
shade_end = 0.90
}
}
}
Gtk 3
* {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#eeeeee, 1.10)),
to(shade(#eeeeee, 0.90)));
border-color: darker(#eeeeee);
}
*:active {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#cccccc, 0.90)),
to(shade(#cccccc, 1.10)));
border-color: darker(#cccccc);
}
*:insensitive {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#aaaaaa, 1.10)),
to(shade(#aaaaaa, 0.90)));
border-color: darker(#aaaaaa);
}
*:hover {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#ffffff, 1.10)),
to(shade(#ffffff, 0.90)));
border-color: darker(#ffffff);
}
*:selected {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#dddddd, 1.10)),
to(shade(#dddddd, 0.90)));
border-color: darker(#dddddd);
}
Linear auto gradient example.
Gtk 2
style "default"
{
bg[ACTIVE] = "#cccccc"
bg[INSENSITIVE] = "#aaaaaa"
bg[NORMAL] = "#eeeeee"
bg[PRELIGHT] = "#ffffff"
bg[selected] = "#dddddd"
engine "xfce"
{
boxfill
{
fill_style = gradient
orientation = auto
shade_start = 1.10
shade_end = 0.90
}
}
}
Gtk 3
.horizontal {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#eeeeee, 1.10)),
to(shade(#eeeeee, 0.90)));
border-color: darker(#eeeeee);
}
.horizontal:active {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#cccccc, 0.90)),
to(shade(#cccccc, 1.10)));
border-color: darker(#cccccc);
}
.horizontal:insensitive {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#aaaaaa, 1.10)),
to(shade(#aaaaaa, 0.90)));
border-color: darker(#aaaaaa);
}
.horizontal:hover {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#ffffff, 1.10)),
to(shade(#ffffff, 0.90)));
border-color: darker(#ffffff);
}
.horizontal:selected {
background-image: -gtk-gradient(linear,
left top, left bottom,
from(shade(#dddddd, 1.10)),
to(shade(#dddddd, 0.90)));
border-color: darker(#dddddd);
}
.vertical {
background-image: -gtk-gradient(linear,
left top, right top,
from(shade(#eeeeee, 1.10)),
to(shade(#eeeeee, 0.90)));
border-color: darker(#eeeeee);
}
.vertical:active {
background-image: -gtk-gradient(linear,
left top, right top,
from(shade(#cccccc, 0.90)),
to(shade(#cccccc, 1.10)));
border-color: darker(#cccccc);
}
.vertical:insensitive {
background-image: -gtk-gradient(linear,
left top, right top,
from(shade(#aaaaaa, 1.10)),
to(shade(#aaaaaa, 0.90)));
border-color: darker(#aaaaaa);
}
.vertical:hover {
background-image: -gtk-gradient(linear,
left top, right top,
from(shade(#ffffff, 1.10)),
to(shade(#ffffff, 0.90)));
border-color: darker(#ffffff);
}
.vertical:selected {
background-image: -gtk-gradient(linear,
left top, right top,
from(shade(#dddddd, 1.10)),
to(shade(#dddddd, 0.90)));
border-color: darker(#dddddd);
}
===== Widget style properties =====
The following table contain a list of the Widget class properties for both Gtk 2 and Gtk 3.
^ Gtk 2 property ^ Type ^ Default value ^ Min ^ Max ^
^ Gtk 3 property ^ ::: ^ ::: ^ ::: ^ ::: ^
^ Description ^^^^^
| GtkArrow::arrow-scaling | float | 0.7 | 0.0 | 1.0 |
| -GtkArrow-arrow-scaling | float | 0.7 | 0.0 | 1.0 |
| Amount of space used up by arrow |||||
| GtkAssistant::header-padding | int | 6 | 0 | G_MAXINT |
| -GtkAssistant-header-padding | int | 6 | 0 | G_MAXINT |
| Number of pixels around the header. |||||
| GtkAssistant::content-padding | int | 1 | 0 | G_MAXINT |
| -GtkAssistant-content-padding | int | 1 | 0 | G_MAXINT |
| Number of pixels around the content pages. |||||
| GtkButtonBox::child-min-width | int | 85 | 0 | G_MAXINT |
| -GtkButtonBox-child-min-width | int | 85 | 0 | G_MAXINT |
| Minimum width of buttons inside the box |||||
| GtkButtonBox::child-min-height | int | 37 | 0 | G_MAXINT |
| -GtkButtonBox-child-min-height | int | 27 | 0 | G_MAXINT |
| Minimum height of buttons inside the box |||||
| GtkButtonBox::child-internal-pad-x | int | 4 | 0 | G_MAXINT |
| -GtkButtonBox-child-internal-pad-x | int | 4 | 0 | G_MAXINT |
| Amount to increase child's size on either side |||||
| GtkButtonBox::child-internal-pad-y | int | 0 | 0 | G_MAXINT |
| -GtkButtonBox-child-internal-pad-y | int | 0 | 0 | G_MAXINT |
| Amount to increase child's size on the top and bottom |||||
| GtkButton::default-border | GtkBorder | | | |
| -GtkButton-default-border | GtkBorder | | | |
| Extra space to add for GTK_CAN_DEFAULT buttons |||||
| GtkButton::default-outside-border | GtkBorder | | | |
| -GtkButton-default-outside-border | GtkBorder | | | |
| Extra space to add for GTK_CAN_DEFAULT buttons that is always drawn outside the border |||||
| GtkButton::child-displacement-x | int | 0 | G_MININT | G_MAXINT |
| -GtkButton-child-displacement-x | int | 0 | G_MININT | G_MAXINT |
| How far in the x direction to move the child when the button is depressed |||||
| GtkButton::child-displacement-y | int | 0 | G_MININT | G_MAXINT |
| -GtkButton-child-displacement-y | int | 0 | G_MININT | G_MAXINT |
| How far in the y direction to move the child when the button is depressed |||||
| GtkButton::displace-focus | boolean | FALSE | | |
| -GtkButton-displace-focus | boolean | FALSE | | |
| Whether the child_displacement_x/_y properties should also affect the focus rectangle |||||
| GtkButton::inner-border | GtkBorder | | | |
| -GtkButton-inner-border | GtkBorder | | | |
| Border between button edges and child. |||||
| GtkButton::image-spacing | int | 2 | 0 | G_MAXINT |
| -GtkButton-image-spacing | int | 2 | 0 | G_MAXINT |
| Spacing in pixels between the image and label |||||
| GtkCalendar::inner-border | int | 4 | 0 | G_MAXINT |
| -GtkCalendar-inner-border | int | 4 | 0 | G_MAXINT |
| Inner border space |||||
| GtkCalendar::vertical-separation | int | 4 | 0 | G_MAXINT |
| -GtkCalendar-vertical-separation | int | 4 | 0 | G_MAXINT |
| Space between day headers and main area |||||
| GtkCalendar::horizontal-separation | int | 4 | 0 | G_MAXINT |
| -GtkCalendar-horizontal-separation | int | 4 | 0 | G_MAXINT |
| Space between week headers and main area |||||
| GtkCheckButton::indicator-size | int | 13 | 0 | G_MAXINT |
| -GtkCheckButton-indicator-size | int | 16 | 0 | G_MAXINT |
| Size of check or radio indicator |||||
| GtkCheckButton::indicator-spacing | int | 2 | 0 | G_MAXINT |
| -GtkCheckButton-indicator-spacing | int | 2 | 0 | G_MAXINT |
| Spacing around check or radio indicator |||||
| GtkCheckMenuItem::indicator-size | int | 13 | 0 | G_MAXINT |
| -GtkCheckMenuItem-indicator-size | int | 16 | 0 | G_MAXINT |
| Size of check or radio indicator |||||
| GtkComboBox::appears-as-list | boolean | FALSE | | |
| -GtkComboBox-appears-as-list | boolean | FALSE | | |
| Whether dropdowns should look like lists rather than menus |||||
| GtkComboBox::arrow-size | int | 15 | 0 | G_MAXINT |
| -GtkComboBox-arrow-size | int | 15 | 0 | G_MAXINT |
| The minimum size of the arrow in the combo box |||||
| -GtkComboBox-arrow-scaling | float | 1.0 | 0 | 2.0 |
| The amount of space used by the arrow |||||
| GtkComboBox::shadow-type | GtkShadowType | GTK_SHADOW_NONE | | |
| -GtkComboBox-shadow-type | GtkShadowType | GTK_SHADOW_NONE | | |
| Which kind of shadow to draw around the combo box |||||
| GtkDialog::content-area-border | int | 2 | 0 | G_MAXINT |
| -GtkDialog-content-area-border | int | 2 | 0 | G_MAXINT |
| Width of border around the main dialog area |||||
| GtkDialog::content-area-spacing | int | 0 | 0 | G_MAXINT |
| -GtkDialog-content-area-spacing | int | 0 | 0 | G_MAXINT |
| Spacing between elements of the main dialog area |||||
| GtkDialog::button-spacing | int | 6 | 0 | G_MAXINT |
| -GtkDialog-button-spacing | int | 6 | 0 | G_MAXINT |
| Spacing between buttons |||||
| GtkDialog::action-area-border | int | 5 | 0 | G_MAXINT |
| -GtkDialog-action-area-border | int | 5 | 0 | G_MAXINT |
| Width of border around the button area at the bottom of the dialog |||||
| GtkEntry::icon-prelight | boolean | TRUE | | |
| -GtkEntry-icon-prelight | boolean | TRUE | | |
| Whether activatable icons should prelight when hovered |||||
| GtkEntry::progress-border | GtkBorder | | | |
| -GtkEntry-progress-border | GtkBorder | | | |
| Border around the progress bar |||||
| GtkEntry::invisible-char | unichar | 0 | | |
| -GtkEntry-invisible-char | unichar | 0 | | |
| The character to use when masking entry contents (in "password mode") |||||
| GtkEntry::inner-border | GtkBorder | | | |
| -GtkEntry-inner-border | GtkBorder | | | |
| Border between text and frame. |||||
| GtkEntry::state-hint | boolean | FALSE | | |
| Whether to pass a proper state when drawing shadow or background |||||
| GtkExpander::expander-size | int | 10 | 0 | G_MAXINT |
| -GtkExpander-expander-size | int | 10 | 0 | G_MAXINT |
| Size of the expander arrow |||||
| GtkExpander::expander-spacing | int | 2 | 0 | G_MAXINT |
| -GtkExpander-expander-spacing | int | 2 | 0 | G_MAXINT |
| Spacing around expander arrow |||||
| GtkIconView::selection-box-color | GdkColor | | | |
| -GtkIconView-selection-box-color | GdkColor | | | |
| Color of the selection box |||||
| GtkIconView::selection-box-alpha | uchar | 0x40 | 0 | 0xff |
| -GtkIconView-selection-box-alpha | uchar | 0x40 | 0 | 0xff |
| Opacity of the selection box |||||
| GtkInfoBar::content-area-border | int | 8 | 0 | G_MAXINT |
| -GtkInfoBar-content-area-border | int | 8 | 0 | G_MAXINT |
| Width of border around the content area |||||
| GtkInfoBar::content-area-spacing | int | 16 | 0 | G_MAXINT |
| -GtkInfoBar-content-area-spacing | int | 16 | 0 | G_MAXINT |
| Spacing between elements of the area |||||
| GtkInfoBar::button-spacing | int | 6 | 0 | G_MAXINT |
| -GtkInfoBar-button-spacing | int | 6 | 0 | G_MAXINT |
| Spacing between buttons |||||
| GtkInfoBar::action-area-border | int | 5 | 0 | G_MAXINT |
| -GtkInfoBar-action-area-border | int | 5 | 0 | G_MAXINT |
| Width of border around the action area |||||
| GtkMenuBar::shadow-type | GtkShadowType | GTK_SHADOW_OUT | | |
| -GtkMenuBar-shadow-type | GtkShadowType | GTK_SHADOW_OUT | | |
| Style of bevel around the menubar |||||
| GtkMenuBar::internal-padding | int | 1 | 0 | G_MAXINT |
| -GtkMenuBar-internal-padding | int | 1 | 0 | G_MAXINT |
| Amount of border space between the menubar shadow and the menu items |||||
| GtkMenu::vertical-padding | int | 1 | 0 | G_MAXINT |
| -GtkMenu-vertical-padding | int | 1 | 0 | G_MAXINT |
| Extra space at the top and bottom of the menu |||||
| GtkMenu::horizontal-padding | int | 0 | 0 | G_MAXINT |
| -GtkMenu-horizontal-padding | int | 0 | 0 | G_MAXINT |
| Extra space at the left and right edges of the menu |||||
| GtkMenu::vertical-offset | int | 0 | G_MININT | G_MAXINT |
| -GtkMenu-vertical-offset | int | 0 | G_MININT | G_MAXINT |
| When the menu is a submenu, position it this number of pixels offset vertically |||||
| GtkMenu::horizontal-offset | int | -2 | G_MININT | G_MAXINT |
| -GtkMenu-horizontal-offset | int | -2 | G_MININT | G_MAXINT |
| When the menu is a submenu, position it this number of pixels offset horizontally |||||
| GtkMenu::double-arrows | boolean | TRUE | | |
| -GtkMenu-double-arrows | boolean | TRUE | | |
| When scrolling, always show both arrows. |||||
| GtkMenu::arrow-placement | GtkArrowPlacement | GTK_ARROWS_BOTH | | |
| -GtkMenu-arrow-placement | GtkArrowPlacement | GTK_ARROWS_BOTH | | |
| Indicates where scroll arrows should be placed |||||
| GtkMenu::arrow-scaling | float | 0.7 | 0.0 | 1.0 |
| -GtkMenu-arrow-scaling | float | 0.7 | 0.0 | 1.0 |
| Arbitrary constant to scale down the size of the scroll arrow |||||
| GtkMenuItem::selected-shadow-type | GtkShadowType | GTK_SHADOW_NONE | | |
| -GtkMeniItem-selected-shadow-type | GtkShadowType, | GTK_SHADOW_NONE | | |
| Shadow type when item is selected |||||
| GtkMenuItem::horizontal-padding | int | 3 | 0 | G_MAXINT |
| -GtkMenuItem-horizontal-padding | int | 3 | 0 | G_MAXINT |
| Padding to left and right of the menu item |||||
| GtkMenuItem::toggle-spacing | int | 5 | 0 | G_MAXINT |
| -GtkMenuItem-toggle-spacing | int | 5 | 0 | G_MAXINT |
| Space between icon and label |||||
| GtkMenuItem::arrow-spacing | int | 10 | 0 | G_MAXINT |
| -GtkMenuItem-arrow-spacing | int | 10 | 0 | G_MAXINT |
| Space between label and arrow |||||
| GtkMenuItem::arrow-scaling | float | 0.8 | 0.0 | 2.0 |
| -GtkMenuItem-arrow-scaling | float | 0.8 | 0.0 | 2.0 |
| Amount of space used up by arrow, relative to the menu item's font size |||||
| GtkMenuItem::width-chars | int | 12 | 0 | G_MAXINT |
| -GtkMenuItem-width-chars | int | 12 | 0 | G_MAXINT |
| The minimum desired width of the menu item in characters |||||
| GtkMessageDialog::message-border | int | 12 | 0 | G_MAXINT |
| -GtkMessageDialog-message-border | int | 12 | 0 | G_MAXINT |
| Width of border around the label and image in the message dialog |||||
| GtkMessageDialog::use-separator | boolean | FALSE | | |
| Whether to put a separator between the message dialog's text and the buttons |||||
| GtkNotebook::has-secondary-backward-stepper | boolean | FALSE | | |
| -GtkNotebook-has-secondary-backward-stepper | boolean | FALSE | | |
| Display a second backward arrow button on the opposite end of the tab area |||||
| GtkNotebook::has-secondary-forward-stepper | boolean | FALSE | | |
| -GtkNotebook-has-secondary-forward-stepper | boolean | FALSE | | |
| Display a second forward arrow button on the opposite end of the tab area |||||
| GtkNotebook::has-backward-stepper | boolean | TRUE | | |
| -GtkNotebook-has-backward-stepper | boolean | TRUE | | |
| Display the standard backward arrow button |||||
| GtkNotebook::has-forward-stepper | boolean | TRUE | | |
| -GtkNotebook-has-forward-stepper | boolean | TRUE | | |
| Display the standard forward arrow button |||||
| GtkNotebook::tab-overlap | int | 2 | G_MININT | G_MAXINT |
| -GtkNotebook-tab-overlap | int | 2 | G_MININT | G_MAXINT |
| Size of tab overlap area |||||
| GtkNotebook::tab-curvature | int | 1 | 0 | G_MAXINT |
| -GtkNotebook-tab-curvature | int | 1 | 0 | G_MAXINT |
| Size of tab curvature |||||
| GtkNotebook::arrow-spacing | int | 0 | 0 | G_MAXINT |
| -GtkNotebook-arrow-spacing | int | 0 | 0 | G_MAXINT |
| Scroll arrow spacing |||||
| -GtkNotebook-initial-gap | int | 0 | 0 | G_MAXINT |
| Initial gap before the first tab |||||
| GtkOptionMenu::indicator-size | GtkRequisition | | | |
| Size of dropdown indicator |||||
| GtkOptionMenu::indicator-spacing | GtkBorder | | | |
| Spacing around indicator |||||
| GtkPaned::handle-size | int | 5 | 0 | G_MAXINT |
| -GtkPaned-handle-size | int | 5 | 0 | G_MAXINT |
| Width of handle |||||
| GtkProgressBar::xspacing | int | 7 | 0 | G_MAXINT |
| -GtkProgressBar-xspacing | int | 7 | 0 | G_MAXINT |
| Extra spacing applied to the width of a progress bar. |||||
| GtkProgressBar::yspacing | int | 7 | 0 | G_MAXINT |
| -GtkProgressBar-yspacing | int | 7 | 0 | G_MAXINT |
| Extra spacing applied to the height of a progress bar. |||||
| GtkProgressBar::min-horizontal-bar-width | int | 150 | 1 | G_MAXINT |
| -GtkProgressBar-min-horizontal-bar-width | int | 150 | 1 | G_MAXINT |
| The minimum horizontal width of the progress bar |||||
| GtkProgressBar::min-horizontal-bar-height | int | 20 | 1 | G_MAXINT |
| -GtkProgressBar-min-horizontal-bar-height | int | 20 | 1 | G_MAXINT |
| The minimum horizontal height of the progress bar |||||
| GtkProgressBar::min-vertical-bar-width | int | 22 | 1 | G_MAXINT |
| -GtkProgressBar-min-vertical-bar-width | int | 22 | 1 | G_MAXINT |
| The minimum vertical width of the progress bar |||||
| GtkProgressBar::min-vertical-bar-height | int | 80 | 1 | G_MAXINT |
| -GtkProgressBar-min-vertical-bar-height | int | 80 | 1 | G_MAXINT |
| The minimum vertical height of the progress bar |||||
| GtkRange::slider-width | int | 14 | 0 | G_MAXINT |
| -GtkRange-slider-width | int | 14 | 0 | G_MAXINT |
| Width of scrollbar or scale thumb |||||
| GtkRange::trough-border | int | 1 | 0 | G_MAXINT |
| -GtkRange-trough-border | int | 1 | 0 | G_MAXINT |
| Spacing between thumb/steppers and outer trough bevel |||||
| GtkRange::stepper-size | int | 14 | 0 | G_MAXINT |
| -GtkRange-stepper-size | int | 14 | 0 | G_MAXINT |
| Length of step buttons at ends |||||
| GtkRange::stepper-spacing | int | 0 | 0 | G_MAXINT |
| -GtkRange-stepper-spacing | int | 0 | 0 | G_MAXINT |
| Spacing between step buttons and thumb |||||
| GtkRange::arrow-displacement-x | int | 0 | G_MININT | G_MAXINT |
| -GtkRange-arrow-displacement-x | int | 0 | G_MININT | G_MAXINT |
| How far in the x direction to move the arrow when the button is depressed |||||
| GtkRange::arrow-displacement-y | int | 0 | G_MININT | G_MAXINT |
| -GtkRange-arrow-displacement-y | int | 0 | G_MININT | G_MAXINT |
| How far in the y direction to move the arrow when the button is depressed |||||
| GtkRange::activate-slider | boolean | FALSE | | |
| With this option set to TRUE, sliders will be drawn ACTIVE and with shadow IN while they are dragged |||||
| GtkRange::trough-side-details | boolean | FALSE | | |
| When TRUE, the parts of the trough on the two sides of the slider are drawn with different details |||||
| GtkRange::trough-under-steppers | boolean | TRUE | | |
| -GtkRange-trough-under-steppers | boolean | TRUE | | |
| Whether to draw trough for full length of range or exclude the steppers and spacing |||||
| GtkRange::arrow-scaling | float | 0.5 | 0.0 | 1.0 |
| -GtkRange-arrow-scaling | float | 0.5 | 0.0 | 1.0 |
| Arrow scaling with regard to scroll button size |||||
| GtkRange::stepper-position-details | boolean | FALSE | | |
| When TRUE, the detail string for rendering the steppers is suffixed with position information |||||
| GtkScale::slider-length | int | 31 | 0 | G_MAXINT |
| -GtkScale-slider-length | int | 31 | 0 | G_MAXINT |
| Length of scale's slider |||||
| GtkScale::value-spacing | int | 2 | 0 | G_MAXINT |
| -GtkScale-value-spacing | int | 2 | 0 | G_MAXINT |
| Space between value text and the slider/trough area |||||
| GtkScrollbar::min-slider-length | int | 21 | 0 | G_MAXINT |
| -GtkScrollbar-min-slider-length | int | 21 | 0 | G_MAXINT |
| Minimum length of scrollbar slider |||||
| GtkScrollbar::fixed-slider-length | boolean | FALSE | | |
| -GtkScrollbar-fixed-slider-length | boolean | FALSE | | |
| Don't change slider size, just lock it to the minimum length |||||
| GtkScrollbar::has-backward-stepper | boolean | TRUE | | |
| -GtkScrollbar-has-backward-stepper | boolean | TRUE | | |
| Display the standard backward arrow button |||||
| GtkScrollbar::has-forward-stepper | boolean | TRUE | | |
| -GtkScrollbar-has-forward-stepper | boolean | TRUE | | |
| Display the standard forward arrow button |||||
| GtkScrollbar::has-secondary-backward-stepper | boolean | FALSE | | |
| -GtkScrollbar-has-secondary-backward-stepper | boolean | FALSE | | |
| Display a second backward arrow button on the opposite end of the scrollbar |||||
| GtkScrollbar::has-secondary-forward-stepper | boolean | FALSE | | |
| Display a second forward arrow button on the opposite end of the scrollbar |||||
| GtkScrolledWindow::scrollbars-within-bevel | boolean | FALSE | | |
| -GtkScrolledWindow-scrollbars-within-bevel | boolean | FALSE | | |
| Place scrollbars within the scrolled window's bevel |||||
| GtkScrolledWindow::scrollbar-spacing | int | 3 | 0 | G_MAXINT |
| -GtkScrolledWindow-scrollbar-spacing | int | 3 | 0 | G_MAXINT |
| Number of pixels between the scrollbars and the scrolled window |||||
| GtkSpinButton::shadow-type | GtkShadowType | GTK_SHADOW_IN | | |
| -GtkSpinButton-shadow-type | GtkShadowType | GTK_SHADOW_IN | | |
| Style of bevel around the spin button |||||
| GtkSpinner::num-steps | uint | 12 | 1 | G_MAXUINT |
| The number of steps for the spinner to complete a full loop. The animation will complete a full cycle in one second by default. |||||
| GtkSpinner::cycle-duration | uint | 1000 | 500 | G_MAXUINT |
| The length of time in milliseconds for the spinner to complete a full loop |||||
| GtkStatusbar::shadow-type | GtkShadowType | GTK_SHADOW_IN | | |
| -GtkStatusbar-shadow-type | GtkShadowType | GTK_SHADOW_IN | | |
| Style of bevel around the statusbar text |||||
| -GtkSwitch-slider-width | int | 36 | 36 | G_MAXINT |
| The minimum width of the handle |||||
| GtkTextView::error-underline-color | GdkColor | | | |
| -GtkTextView-error-underline-color | GdkColor | | | |
| Color with which to draw error-indication underlines |||||
| GtkToolbar::space-size | int | 12 | 0 | G_MAXINT |
| -GtkToolbar-space-size | int | 12 | 0 | G_MAXINT |
| Size of spacers |||||
| GtkToolbar::internal-padding | int | 0 | 0 | G_MAXINT |
| -GtkToolbar-internal-padding | int | 0 | 0 | G_MAXINT |
| Amount of border space between the toolbar shadow and the buttons |||||
| GtkToolbar::max-child-expand | int | G_MAXINT | 0 | G_MAXINT |
| -GtkToolbar-max-child-expand | int | G_MAXINT | 0 | G_MAXINT |
| Maximum amount of space an expandable item will be given |||||
| GtkToolbar::space-style | GtkToolbarSpaceStyle | GTK_TOOLBAR_SPACE_LINE | | |
| -GtkToolbar-space-style | GtkToolbarSpaceStyle | GTK_TOOLBAR_SPACE_LINE | | |
| Whether spacers are vertical lines or just blank |||||
| GtkToolbar::button-relief | GtkReliefStyle | GTK_RELIEF_NONE | | |
| -GtkToolbar-button-relief | GtkReliefStyle | GTK_RELIEF_NONE | | |
| Type of bevel around toolbar buttons |||||
| GtkToolbar::shadow-type | GtkShadowType | GTK_SHADOW_OUT | | |
| -GtkToolbar-shadow-type | GtkShadowType | GTK_SHADOW_OUT | | |
| Style of bevel around the toolbar |||||
| GtkToolButton::icon-spacing | int | 3 | 0 | G_MAXINT |
| -GtkToolButton-icon-spacing | int | 3 | 0 | G_MAXINT |
| Spacing in pixels between the icon and label |||||
| GtkToolItemGroup::expander-size | int | 16 | 0 | G_MAXINT |
| -GtkToolItemGroup-expander-size | int | 16 | 0 | G_MAXINT |
| Size of the expander arrow |||||
| GtkToolItemGroup::header-spacing | int | 2 | 0 | G_MAXINT |
| -GtkToolItemGroup-header-spacing | int | 2 | 0 | G_MAXINT |
| Spacing between expander arrow and caption |||||
| GtkTreeView::expander-size | int | 12 | 0 | G_MAXINT |
| -GtkTreeView-expander-size | int | 14 | 0 | G_MAXINT |
| Size of the expander arrow |||||
| GtkTreeView::vertical-separator | int | 2 | 0 | G_MAXINT |
| -GtkTreeView-vertical-separator | int | 2 | 0 | G_MAXINT |
| Vertical space between cells. Must be an even number |||||
| GtkTreeView::horizontal-separator | int | 2 | 0 | G_MAXINT |
| -GtkTreeView-horizontal-separator | int | 2 | 0 | G_MAXINT |
| Horizontal space between cells. Must be an even number |||||
| GtkTreeView::allow-rules | boolean | TRUE | | |
| -GtkTreeView-allow-rules | boolean | TRUE | | |
| Allow drawing of alternating color rows |||||
| GtkTreeView::indent-expanders | boolean | TRUE | | |
| -GtkTreeView-indent-expanders | boolean | TRUE | | |
| Make the expanders indented |||||
| GtkTreeView::even-row-color | GdkColor | | | |
| -GtkTreeView-even-row-color | GdkColor | | | |
| Color to use for even rows |||||
| GtkTreeView::odd-row-color | GdkColor | | | |
| -GtkTreeView-odd-row-color | GdkColor | | | |
| Color to use for odd rows |||||
| GtkTreeView::row-ending-details | boolean | FALSE | | |
| Enable extended row background theming |||||
| GtkTreeView::grid-line-width | int | 1 | 0 | G_MAXINT |
| -GtkTreeView-grid-line-width | int | 1 | 0 | G_MAXINT |
| Width, in pixels, of the tree view grid lines |||||
| GtkTreeView::tree-line-width | int | 1 | 0 | G_MAXINT |
| -GtkTreeView-tree-line-width | int | 1 | 0 | G_MAXINT |
| Width, in pixels, of the tree view lines |||||
| GtkTreeView::grid-line-pattern | string | "\1\1" | | |
| -GtkTreeView-grid-line-pattern | string | "\1\1" | | |
| Dash pattern used to draw the tree view grid lines |||||
| GtkTreeView::tree-line-pattern | string | "\1\1" | | |
| -GtkTreeView-tree-line-pattern | string | "\1\1" | | |
| Dash pattern used to draw the tree view lines |||||
| GtkWidget::interior-focus | boolean | TRUE | | |
| -GtkWidget-interior-focus | boolean | TRUE | | |
| Whether to draw the focus indicator inside widgets |||||
| GtkWidget::focus-line-width | int | 1 | 0 | G_MAXINT |
| -GtkWidget-focus-line-width | int | 1 | 0 | G_MAXINT |
| Width, in pixels, of the focus indicator line |||||
| GtkWidget::focus-line-pattern | string | "\1\1" | | |
| -GtkWidget-focus-line-pattern | string | "\1\1" | | |
| Dash pattern used to draw the focus indicator |||||
| GtkWidget::focus-padding | int | 1 | 0 | G_MAXINT |
| -GtkWidget-focus-padding | int | 1 | 0 | G_MAXINT |
| Width, in pixels, between focus indicator and the widget 'box' |||||
| GtkWidget::cursor-color | GdkColor | | | |
| -GtkWidget-cursor-color | GdkColor | | | |
| Color with which to draw insertion cursor |||||
| GtkWidget::secondary-cursor-color | GdkColor | | | |
| -GtkWidget-secondary-cursor-color | GdkColor | | | |
| Color with which to draw the secondary insertion cursor when editing mixed right-to-left and left-to-right text |||||
| GtkWidget::cursor-aspect-ratio | float | 0.04 | 0.0 | 1.0 |
| -GtkWidget-cursor-aspect-ratio | float | 0.04 | 0.0 | 1.0 |
| Aspect ratio with which to draw insertion cursor |||||
| GtkWidget::draw-border | GtkBorder | | | |
| Size of areas outside the widget's allocation to draw |||||
| -GtkWidget-window-dragging | boolean | FALSE | | |
| Whether windows can be dragged by clicking on empty areas |||||
| GtkWidget::link-color | GdkColor | | | |
| -GtkWidget-link-color | GdkColor | | | |
| Color of unvisited links |||||
| GtkWidget::visited-link-color | GdkColor | | | |
| -GtkWidget-visited-link-color | GdkColor | | | |
| Color of visited links |||||
| GtkWidget::wide-separators | boolean | FALSE | | |
| -GtkWidget-wide-separators | boolean | FALSE | | |
| Whether separators have configurable width and should be drawn using a box instead of a line |||||
| GtkWidget::separator-width | int | 0 | 0 | G_MAXINT |
| -GtkWidget-separator-width | int | 0 | 0 | G_MAXINT |
| The width of separators if wide-separators is TRUE |||||
| GtkWidget::separator-height | int | 0 | 0 | G_MAXINT |
| -GtkWidget-separator-height | int | 0 | 0 | G_MAXINT |
| The height of separators if "wide-separators" is TRUE |||||
| GtkWidget::scroll-arrow-hlength | int | 16 | 1 | G_MAXINT |
| -GtkWidget-scroll-arrow-hlength | int | 16 | 1 | G_MAXINT |
| The length of horizontal scroll arrows |||||
| GtkWidget::scroll-arrow-vlength | int | 16 | 1 | G_MAXINT |
| -GtkWidget-scroll-arrow-vlength | int | 16 | 1 | G_MAXINT |
| The length of vertical scroll arrows |||||
| -GtkWindow-resize-grip-width | int | 16 | 0 | G_MAXINT |
| Width of resize grip |||||
| -GtkWindow-resize-grip-height | int | 16 | 0 | G_MAXINT |
| Height of resize grip |||||
===== See also =====
* [[howto:xfwm4_theme|Xfwm4 theme how-to]]
* [[http://developer.gnome.org/gtk3/3.2/gtk-migrating-GtkStyleContext.html|Gtk 3 Theming changes]]