Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

Tutorial: Window Decoration Theme

Window Decorations

A title theme is positioned over the window title of maximised windows. If the window title size and the system title size do not match, some of the application window will be obscured, or there will be an empty area at the top of the application. Therefore it is essential that the window decoration metrics match the title theme.

The two window states available are:

maximized
normal.

In each state the following metrics are supported:

Metric	Description
`TitleHeight`	The height of the title
`LeftBorder`	The width of the left border
`RightBorder`	The width of the right border
`TopBorder`	The height of the top border (above the title)
`BottomBorder`	The height of the bottom border
`CornerGrabSize`	The length of the region in each corner that can be used to resize the window

The following pixmaps may be supplied:

Pixmap	Description
`TitlePixmap`	The pixmap to be drawn at the top of the window
`OverlayPixmap`	Drawn over the top of the TitlePixmap. This allows an area of the title to be tinted a different color. An example of this is the highlight colored area in the portal theme.
`LeftPixmap`	The pixmap to be drawn to the left of the window
`RightPixmap`	The pixmap to be drawn to the right of the window
`BottomPixmap`	The pixmap to be drawn at the bottom of the window

For each pixmap the following properties may be set:

Property	Description
`<Title\|Overlay\|Left\|Right\|Bottom>;Offsets`	Specifies the position of the tileable area of the image. For example, "TitleOffsets=16,48" says that the image to be used for the title should place the first 16 pixels at the left, the pixels from 48 on the right, and tile the pixels in between.
`<Title\|Overlay\|Left\|Right\|Bottom>;Color`	Specifies the color to tint the image. May be a rgb color spec (#FFFFFF) or a Qt palette color name.

The following example illustrates the format of the decoration configuration file:

    [Decoration]
    Name = Portal
    Base = themes/portal

    [Maximized]
    TitleHeight = 34
    TitlePixmap = titlebg_0
    TitleOffsets = 87,88

    [Normal]
    TitleHeight = 19
    TitlePixmap = titlebox
    TitleOffsets = 8,56
    OverlayPixmap = titlebox_overlay
    OverlayOffsets = 16,48

Trademarks

Qt Extended 4.4.3