User Tools

Site Tools


Standard Color Roles

The interface is drawn using a palette of 20 different colors. The Style Definition should specify a Value for each of these colors using the Color element.

The standard color roles are:

  • Window - A general background color.
  • WindowText - A general foreground color.
  • Base - Used mostly as the background color for text entry widgets, but can also be used for other painting - such as the background of combobox drop down lists and toolbar handles. It is usually white or another light color.
  • AlternateBase - Used as the alternate background color in views with alternating row colors.
  • Text - The foreground color used with Base. This is usually the same as the WindowText, in which case it must provide good contrast with Window and Base.
  • Button - The general button background color. This background can be different from Window as some styles require a different background color for buttons.
  • ButtonText - A foreground color used with the Button color.
  • BrightText - A text color that is very different from WindowText, and contrasts well with, for example, Dark. Typically used for text that needs to be drawn where Text or WindowText would give poor contrast, such as on pressed push buttons. Note that text colors can be used for things other than just words; text colors are usually used for text, but it's quite common to use the text color roles for lines, icons, etc.
  • ToolTipBase - Used as the background color for ToolTip and WhatsThis popup widgets.
  • ToolTipText - Used as the foreground color for ToolTip and WhatsThis popup widgets.
  • Light - Lighter than Button color.
  • Midlight - Between Button and Light.
  • Mid - Between Button and Dark.
  • Dark - Darker than Button.
  • Shadow - A very dark color.
  • Highlight - A color to indicate a selected item or the current item.
  • HighlightedText - A text color that contrasts with Highlight.
  • Link - A text color used for unvisited hyperlinks.
  • LinkVisited - A text color used for already visited hyperlinks.
  • NoRole - A special role is often used to indicate that a role has not been assigned.