HelpSource/Reference/palette_color_roles.schelp

   1 title:: Color roles
   2 categories:: GUI>Accessories
   3 summary:: A list of color roles within a palette, and their meaning
   4
   5 A palette (see link::Classes/QPalette::) consists of colors assigned to various color roles within the three color groups (see link::Reference/palette_color_groups::). The following is a list of possible symbols to denote color roles, and their meanings.
   6
   7 table::
   8 ## strong::Role::    || strong::Meaning::
   9 ## 'window'          || Window background. Views may also use this role, for example to derive the color of their border. It is also the background of StaticText.
  10 ## 'windowText'      || Text on top of 'window', for example in StaticText.
  11 ## 'button'          || Everything button-alike. For example Button background, as well as Slider thumb.
  12 ## 'buttonText'      || Text on top of 'button'.
  13 ## 'brightText'      || May be used for text on pressed Button.
  14 ## 'base'            || Background of views that display a lot of text (TextView, ListView, etc.).
  15 ## 'baseText'        || Text on top of 'base'.
  16 ## 'alternateBase'   || ListView may use alternate background colors for rows.
  17 ## 'toolTipBase'     || Background of tooltips.
  18 ## 'toolTipText'     || Text of tooltips.
  19 ## 'highlight'       || Used to indicate selection, as in ListView, etc.
  20 ## 'highlightText'   || Selected text / item.
  21 ## 'link'            || Default color for links on a web page.
  22 ## 'linkVisited'     || Default color for visited links on a web page.
  23 ::
  24
  25 Additionally, the following roles are used to create 3D effects:
  26
  27 table::
  28 ## strong::Role::    || strong::Meaning::
  29 ## 'light'           || Lighter than 'button'.
  30 ## 'midlight'        || Between 'button' and 'light'.
  31 ## 'middark'         || Between 'button' and 'dark'.
  32 ## 'dark'            || Darker than 'button'.
  33 ## 'shadow'          || A very dark color.
  34 ::