KDecoration2 Namespace Reference

Classes
class	DecoratedClient
class	Decoration
class	DecorationButton
class	DecorationButtonGroup
class	DecorationSettings
class	DecorationShadow
class	DecorationThemeMetaData
class	DecorationThemeProvider

Enumerations
enum class	BorderSize {   None , NoSides , Tiny , Normal ,   Large , VeryLarge , Huge , VeryHuge ,   Oversized }
enum class	ColorGroup { Inactive , Active , Warning }
enum class	ColorRole { Frame , TitleBar , Foreground }
enum class	DecorationButtonType {   Menu , ApplicationMenu , OnAllDesktops , Minimize ,   Maximize , Close , ContextHelp , Shade ,   KeepBelow , KeepAbove , Custom , Spacer }

Detailed Description

Framework for creating window decorations.

Enumeration Type Documentation

BorderSize

enum class KDecoration2::BorderSize

strong

Border sizes are a combination of visual and accessibility features.

Larger borders should be used to increase the non title bar borders to make it easier to resize the decoration

Enumerator
None	Border sizes of all non title bar sides should be set to 0.
NoSides	Border sizes of the sides should be set to 0. Title bar and the border on opposite side of the title bar should follow the Normal settings.
Tiny	Borders should be smaller than Normal, e.g. a factor of 0.5.
Normal	The default border size with borders on each side. This should be the base for calculating other border sizes.
Large	Increased border sizes, considered a factor of 1.5.
VeryLarge	Increased border sizes, considered a factor of 2.0.
Huge	Increased border sizes, considered a factor of 2.5.
VeryHuge	Increased border sizes, considered a factor of 3.0.
Oversized	Increased border sizes, considered a factor of 5.0.

Definition at line 82 of file decorationdefines.h.

ColorGroup

enum class KDecoration2::ColorGroup

strong

Color groups are used for DecoratedClient::color().

Since

5.3

Enumerator
Inactive	Inactive color, used for unfocused windows.
Active	Active color, used for focused windows.
Warning	Warning color, can only be used with ColorRole::Foreground. If used with other roles, a invalid QColor is returned. It can be used for close buttons and is typically red.

Definition at line 128 of file decorationdefines.h.

ColorRole

enum class KDecoration2::ColorRole

strong

Color roles are used for DecoratedClient::color().

Since

5.3

Enumerator
Frame	The decoration's frame background color.
TitleBar	The decoration's title bar background color.
Foreground	The decoration's title bar forground color.

Definition at line 148 of file decorationdefines.h.

DecorationButtonType

enum class KDecoration2::DecorationButtonType

strong

The DecorationButtonType is a helper type for the DecorationButton.

A Decoration should provide a DecorationButton for each of the types, if it wants to provide further buttons it should use the Custom type. The DecorationButton gets configured depending on the type. E.g. the Close button gets disabled if the DecoratedClient is not closeable.

Enumerator
Menu	The Menu button requests showing the window menu on left or right click.
ApplicationMenu	The ApplicationMenu button requests showing the application's menu on left or right click.
OnAllDesktops	The OnAllDesktops button requests toggling the DecoratedClient's on all desktops state. The DecoratedButton is only visible if multiple virtual desktops are available.
Minimize	The Minimize button requests minimizing the DecoratedClient. The DecorationButton is only enabled if the DecoratedClient is minimizeable.
Maximize	The Maximize button requests maximizing the DecoratedClient. The DecorationButton is checkable and if the DecoratedClient is maximized the DecorationButton is checked. The DecorationButton supports multiple mouse buttons to change horizontal, vertical and overall maximized state. The DecorationButton is only enabled if the DecoratedClient is maximizeable.
Close	The Close button requests closing the DecoratedClient. The DecorationButton is only enabled if the DecoratedClient is closeable.
ContextHelp	The ContextHelp button requests entering the context help mode. The DecorationButton is only visible if the DecoratedClient provides context help.
Shade	The Shade button requests toggling the DecoratedClient's shaded state. The DecoratedButton is only enabled if the DecoratedClient is shadeable.
KeepBelow	The KeepBelow button requests toggling the DecoratedClient's keep below state.
KeepAbove	The KeepAbove button requests toggling the DecoratedClient's keep above state.
Custom	The Custom type allows a Decoration to provide custom DecorationButtons.
Spacer	The Spacer button provides some space between buttons.

Definition at line 17 of file decorationdefines.h.