Resizable widget list

Here we list all of the resizable widgets that are currently available for you to theme. This does not include fixed sized widgets, which are handled a little differently and are described next.

Included is the widget type, the configuration group key, and some notes if applicable. Also important to note is that many widgets have a normal and "down" state. If you theme the normal state the down state will automatically inherit the settings. See the page on inheritance for more information about this feature (included later in this tutorial).

One last thing to remember concerns the "Background" group. This defines the primary widget background and is used when there is no other widget in a given area. The thing you have to remember is some widgets like QLabel also use this pixmap, but don't calculate a new offset to draw the pixmap based on where it is in the main widget but draw it at (0,0) inside the pixmap. Thus your primary background pixmap should be able to be tiled and look decent starting at any point in the pixmap. See the Marble and System themes included with KDE for an example of this.

This restriction is likely to change in future versions of Qt. Matthias Ettrich already changed QToolButton, which uses the primary background pixmap until the mouse moves over it, to properly offset the pixmap depending on where it is.

Another thing to remember about the primary background pixmap is that KWin utilizes KDE styles as well, and some KWin styles such as the standard KDE and System style will also be using the pixmap via KStyle. Keep this in mind when seeing how well your pixmap tiles.

The "Background" group should only contain a pixmap. To define colors use the standard KDE color scheme mechanism. Gradients and effects are not supported for this item.

Widget Config Group Key Notes
PushButton [PushButton]
Sunken PushButton [PushButtonDown]
ComboBox [ComboBox] You also need to set ComboDeco (described next)
Sunken ComboBox [ComboBoxDown]
Horizontal Scrollbar Slider [HSBarSlider]
Sunken Horizontal Scrollbar Slider [HSBarSliderDown]
Vertical Scrollbar Slider [VSBarSlider]
Sunken Vertical Scrollbar Slider [VSBarSliderDown]
Generic Bevel [Bevel]
Sunken Generic Bevel [BevelDown]
Toolbar Button [ToolButton] Recommended you theme
Sunken Toolbar Button [ToolButtonDown]
Scrollbar Button [ScrollButton]
Sunken Scrollbar Button [ScrollButtonDown]
Normal Menu Items [MenuItem]
Active Menu Item [MenuItemDown] Recommended you theme
Inactive Tabs [Tab] Recommended you theme
Active Tab [TabDown] Recommended you theme
Horizontal ScrollBar Groove [HScrollGroove]
Vertical ScrollBar Groove [VScrollGroove]
Slider Groove [SliderGroove]
Horizontal Tool/Menubar Handle [HBarHandle] Recommended you theme
Vertical Tool/Menubar Handle [VBarHandle] Recommended you theme
ToolBar [ToolBar] Recommended you theme
Splitter [Splitter]
MenuBar [MenuBar] Recommended you theme
Progress Indicator Bar [ProgressBar]
Progress Indicator Background [ProgressBackground] Pixmap and color setting only
Active Menubar Item [Menu]
Primary Widget Background [Background] Pixmap setting only

<< Previous Page | Next Page >>

Mail Mosfet