# class KColorScheme

###

Module | kdeui
Namespace |
Class | KColorScheme
Inherits |

A set of methods used to work with colors.

KColorScheme currently provides access to the system color palette that the user has selected (in the future, it is expected to do more). As of KDE4, this class is the correct way to look up colors from the system palette, as opposed to KGlobalSettings (such usage is deprecated). It greatly expands on KGlobalSettings and QPalette by providing five distinct "sets" with several color choices each, covering background, foreground, and decoration colors.

A KColorScheme instance represents colors corresponding to a "set", where a set consists of those colors used to draw a particular type of element, such as a menu, button, view, selected text, or tooltip. Each set has a distinct set of colors, so you should always use the correct set for drawing and never assume that a particular foreground for one set is the same as the foreground for any other set. Individual colors may be quickly referenced by creating an anonymous instance and invoking a lookup member.

Historically, it was not needed for applications to give much concern to the state of a widget (active, inactive, disabled) since only the disabled state was different, and only slightly. As a result, the old KGlobalSettings color getters did not care about the widget state. However, starting with KDE4, the color palettes for the various states may be wildly different. Therefore, it is important to take the state into account. This is why the KColorScheme constructor requires a QPalette.ColorGroup as an argument.

To facilitate working with potentially-varying states, two convenience API's are provided. These are KColorScheme.adjustBackground and its sister KColorScheme.adjustForeground, and the helper class .KStatefulBrush.

See also KColorScheme.ColorSet, KColorScheme.ForegroundRole, KColorScheme.BackgroundRole, KColorScheme.DecorationRole, KColorScheme.ShadeRole

### enums

- BackgroundRole { NormalBackground, AlternateBackground, ActiveBackground, LinkBackground, VisitedBackground, NegativeBackground, NeutralBackground, PositiveBackground }
- ColorSet { View, Window, Button, Selection, Tooltip }
- DecorationRole { FocusColor, HoverColor }
- ForegroundRole { NormalText, InactiveText, ActiveText, LinkText, VisitedText, NegativeText, NeutralText, PositiveText }
- ShadeRole { LightShade, MidlightShade, MidShade, DarkShade, ShadowShade }

enum details

### methods

- KColorScheme (a0)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  a0 | KColorScheme |

  Construct a copy of another KColorScheme.

- KColorScheme (a0, a1, a2)

  returns ctor
  KDE 4.1.0 and later only

  Argument | Type | Default
  --- | --- | ---
  a0 | QPalette.ColorGroup |
  a1 | KColorScheme.ColorSet | KColorScheme.View
  a2 | KSharedConfigPtr | KSharedConfigPtr()

  Construct a palette from given color set and state, using the colors from the given KConfig (if null, the system colors are used).

  KColorScheme provides direct access to the color scheme for users that deal directly with widget states. Unless you are a low-level user or have a legitimate reason to only care about a fixed, limited number of states (e.g. windows that cannot be inactive), consider using a .KStatefulBrush instead.

- KColorScheme (a0, a1, a2)

  returns ctor
  before KDE 4.1.0 only

  Argument | Type | Default
  --- | --- | ---
  a0 | QPalette.ColorGroup |
  a1 | KColorScheme.ColorSet | KColorScheme.View
  a2 | KSharedConfigPtr | KSharedConfigPtr()

- adjustBackground (a0, newRole, color, set, a1)

  returns Nothing
  static

  Argument | Type | Default
  --- | --- | ---
  a0 | QPalette |
  newRole | KColorScheme.BackgroundRole | KColorScheme.NormalBackground
  color | QPalette.ColorRole | QPalette.Base
  set | KColorScheme.ColorSet | KColorScheme.View
  a1 | KSharedConfigPtr | KSharedConfigPtr()

  Adjust a QPalette by replacing the specified QPalette.ColorRole with the requested background color for all states. Using this method is safer than replacing individual states, as it insulates you against changes in QPalette.ColorGroup.

  Although it is possible to replace a foreground color using this method, it's bad usability to do so. Just say "no".

- adjustForeground (a0, newRole, color, set, a1)

  returns Nothing
  static

  Argument | Type | Default
  --- | --- | ---
  a0 | QPalette |
  newRole | KColorScheme.ForegroundRole | KColorScheme.NormalText
  color | QPalette.ColorRole | QPalette.Text
  set | KColorScheme.ColorSet | KColorScheme.View
  a1 | KSharedConfigPtr | KSharedConfigPtr()

  Adjust a QPalette by replacing the specified QPalette.ColorRole with the requested foreground color for all states. Using this method is safer than replacing individual states, as it insulates you against changes in QPalette.ColorGroup.

  Although it is possible to replace a background color using this method, it's bad usability to do so. Just say "no".

- background (a0)

  returns QBrush

  Argument | Type | Default
  --- | --- | ---
  a0 | KColorScheme.BackgroundRole | KColorScheme.NormalBackground

  Retrieve the requested background brush.

- decoration (a0)

  returns QBrush

  Argument | Type | Default
  --- | --- | ---
  a0 | KColorScheme.DecorationRole |

  Retrieve the requested decoration brush.

- foreground (a0)

  returns QBrush

  Argument | Type | Default
  --- | --- | ---
  a0 | KColorScheme.ForegroundRole | KColorScheme.NormalText

  Retrieve the requested foreground brush.

- shade (a0)

  returns QColor

  Argument | Type | Default
  --- | --- | ---
  a0 | KColorScheme.ShadeRole |

  Retrieve the requested shade color, using KColorScheme.background(KColorScheme.NormalBackground) as the base color and the contrast setting from the KConfig used to create this KColorScheme instance (the system contrast setting, if no KConfig was specified).

  Shades are chosen such that all shades would contrast with the base color. This means that if base is very dark, the 'dark' shades will be lighter than the base color, with midlight() == shadow(). Conversely, if the base color is very light, the 'light' shades will be darker than the base color, with light() == mid().

- shade (a0, a1)

  returns QColor
  static

  Argument | Type | Default
  --- | --- | ---
  a0 | QColor |
  a1 | KColorScheme.ShadeRole |

  Retrieve the requested shade color, using the specified color as the base color and the system contrast setting.

  Shades are chosen such that all shades would contrast with the base color. This means that if base is very dark, the 'dark' shades will be lighter than the base color, with midlight() == shadow(). Conversely, if the base color is very light, the 'light' shades will be darker than the base color, with light() == mid().

- shade (a0, a1, contrast, chromaAdjust)

  returns QColor
  static

  Argument | Type | Default
  --- | --- | ---
  a0 | QColor |
  a1 | KColorScheme.ShadeRole |
  contrast | qreal |
  chromaAdjust | qreal | 0.0

  Retrieve the requested shade color, using the specified color as the base color and the specified contrast.

  contrast - Amount roughly specifying the contrast by which to adjust the base color, between -1.0 and 1.0 (values between 0.0 and 1.0 correspond to the value from KGlobalSettings.contrastF)

  chromaAdjust - (optional) Amount by which to adjust the chroma of the shade (1.0 means no adjustment)

  Shades are chosen such that all shades would contrast with the base color. This means that if base is very dark, the 'dark' shades will be lighter than the base color, with midlight() == shadow(). Conversely, if the base color is very light, the 'light' shades will be darker than the base color, with light() == mid().

  See also KColorUtils.shade

### enums - detail

- BackgroundRole { NormalBackground, AlternateBackground, ActiveBackground, LinkBackground, VisitedBackground, NegativeBackground, NeutralBackground, PositiveBackground }

  Normal background.

  | NormalBackground | - 0 | - |
  | AlternateBackground | - 1 | - |
  | ActiveBackground | - 2 | - |
  | LinkBackground | - 3 | - |
  | VisitedBackground | - 4 | - |
  | NegativeBackground | - 5 | - |
  | NeutralBackground | - 6 | - |
  | PositiveBackground | - 7 | - |

- ColorSet { View, Window, Button, Selection, Tooltip }

  Views; for example, frames, input fields, etc.

  If it contains things that can be selected, it is probably a View.

  | View | - | - |
  | Window | - | - |
  | Button | - | - |
  | Selection | - | - |
  | Tooltip | - | - |

- DecorationRole { FocusColor, HoverColor }

  Color used to draw decorations for items which have input focus.

  | FocusColor | - | - |
  | HoverColor | - | - |

- ForegroundRole { NormalText, InactiveText, ActiveText, LinkText, VisitedText, NegativeText, NeutralText, PositiveText }

  Normal foreground.

  | NormalText | - 0 | - |
  | InactiveText | - 1 | - |
  | ActiveText | - 2 | - |
  | LinkText | - 3 | - |
  | VisitedText | - 4 | - |
  | NegativeText | - 5 | - |
  | NeutralText | - 6 | - |
  | PositiveText | - 7 | - |

- ShadeRole { LightShade, MidlightShade, MidShade, DarkShade, ShadowShade }

  The light color is lighter than dark() or shadow() and contrasts with the base color.

  | LightShade | - | - |
  | MidlightShade | - | - |
  | MidShade | - | - |
  | DarkShade | - | - |
  | ShadowShade | - | - |