<type>documentation</type>
<domain>custom</domain>
<id>qt-styles</id>
<title>Display Style and Colors</title>
<date>$Date: 2007-09-24 23:16:39 -0400 (Mon, 24 Sep 2007) $</date>
<version>$Revision: 16483 $</version>
<product>all</product>
<product-version>5+</product-version>

By default Wing runs with native look and feel for each OS (except on Linux
where it cannot use the system-provided UI libraries), and with a classic white
background style for the editor.

**Editor Color Configuration**

The colors used for the user interface are selected with the `User Interface > Color Palette
<script:show_preferences_gui#prefname="gui.qt-color-palette">`__ preference.
This affects editor background color and the color of markers on text such
as the selection, debug run marker, caret line highlight, bookmarks, diff/merge
annotations, and other configurable colors.  Palettes also define 20 additional
colors that appear in preferences menus that are used for selecting colors.

Most of the defaults set by the color palette preference can be overridden on a value-by-value 
basis in preferences. For example, the `Editor > Selection/Caret > Selection Color
<script:show_preferences_gui#prefname="gui.qt-text-selection-color">`__
preference is used to change the text selection color to a value other than
the one specified in the selected color palette.  Each such preference allows
selection of a color from the current color palette, or an arbitrary
color from a color chooser dialog.

~~~if not WING101:
In Wing Pro and Wing Personal, the colors used for syntax highlighting code in the editor can be configured
separately, as described in `Custom Syntax Coloring <ref:custom/syntax>`__.
~~~

**UI Color Configuration**

To apply the color palette also to the UI outside of the editor, enable the 
`User Interface > Use Color Palette Throughout the UI 
<script:show_preferences_gui#prefname="gui.use-palette-throughout-ui">`__
preference.  This is the way to change Wing to using a uniform background color.  For
a dark background use this option together with ``One Dark`` or one of the other
dark themed palettes.

**Add Color Palettes**

Additional color palettes can be defined and stored in the ``palettes`` sub-directory
of the `Settings Directory <ref:install/user-settings-dir>`__.  This directory
must be created if it does not already exist.  Example palettes
are included in your Wing installation in ``resources/palettes``.  After adding
a palette in this way, Wing must be restarted to make it available for use.
