---
description: >-
  A module containing dynamic system colors for macOS and Windows and color
  manipulation methods, mainly for macOS
---

# NSColorAddition

{% hint style="info" %}
Module
{% endhint %}

## Overview

### Methods

| Overview                                                                                                      |                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [AddSystemEffect](#addsystemeffect-extends-c-as-color-effect-as-nscoloraddition-nscolorsystemeffect-as-color) | [BlendColor](#blendcolor-extends-c-as-color-blendcolor-as-color-fraction-as-double-as-color)                                                |
| [ChangeAlpha](#changealpha-extends-c-as-color-alpha-as-double-integer-as-color)                               | [Draw](#draw-extends-c-as-color-optional-g-as-graphics-x-as-double-y-as-double-w-as-double-h-as-double)                                     |
| [FillRectangle](#fillrectangle-extends-g-as-graphics-x-as-double-y-as-double-w-as-double-h-as-double)         | [Highlight](#highlight-extends-c-as-color-level-as-double-as-color)                                                                         |
| [MultiplyColor](#multiplycolor-extends-c-as-color-level-as-double-1-0-as-color)                               | [RegisterForSystemColorChangeNotification](#registerforsystemcolorchangenotification-receiver-as-nscoloraddition-systemcolorchangereceiver) |
| [ScrubberTexturedBackgroundColor](#scrubbertexturedbackgroundcolor-as-ptr)                                    | [SetColor](#setcolor-extends-c-as-color)                                                                                                    |
| [SetFillColor](#setfillcolor-extends-c-as-color)                                                              | [SetStrokeColor](#setstrokecolor-extends-c-as-color)                                                                                        |
| [Shadow](#shadow-extends-c-as-color-level-as-double-as-color)                                                 | [SystemVersionIsAtLeast](#systemversionisatleast-majorversion-as-integer-minorversion-as-integer-0-patchversion-as-integer-0-as-boolean)    |

### Properties

{% hint style="info" %}
The macOS colors are also available as methods returning the Ptr to the NSColor representation of the color. To avoid confusions with the Xojo built-in colors, the module’s Xojo colors are named with an underline before "Color" while the methods are protected module methods and don’t use an underscore in their name. \
The exception is _ScrubberTexturedBackgroundColor_ which has no Xojo color translation. It is a macOS only NSColor made of a repeating image.
{% endhint %}

| Overview                                                                                                                                                                                         |                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [AlternateSelectedControlText\_Color](#alternateselectedcontroltext_color-as-color)                                                                                                              | [AlternatingContentBackground\_Color0](#alternatingcontentbackground_color0-as-color)                                                                                                           |
| [AlternatingContentBackground\_Color1](#alternatingcontentbackground_color1-as-color)                                                                                                            | [Clear\_Color](#clear_color-as-color)                                                                                                                                                           |
| [ControlAccent\_Color](#controlaccent_color-as-color)                                                                                                                                            | [ControlBackground\_Color](#controlbackground_color-as-color)                                                                                                                                   |
| [ControlText\_Color](#controltext_color-as-color)                                                                                                                                                | [Control\_Color](#control_color-as-color)                                                                                                                                                       |
| [CurrentControl\_Tint](#currentcontrol_tint-as-nscontroltint)                                                                                                                                    | [DisabledControlText\_Color](#disabledcontroltext_color-as-color)                                                                                                                               |
| [FindHighlight\_Color](#findhighlight_color-as-color)                                                                                                                                            | [Grid\_Color](#grid_color-as-color)                                                                                                                                                             |
| [HeaderText\_Color](#headertext_color-as-color)                                                                                                                                                  | [Highlight\_Color](#highlight_color-as-color)                                                                                                                                                   |
| [KeyboardFocusIndicator\_Color](#keyboardfocusindicator_color-as-color)                                                                                                                          | [Label\_Color](#label_color-as-color)                                                                                                                                                           |
| [Link\_Color](#link_color-as-color)                                                                                                                                                              | [PlaceholderText\_Color](#placeholdertext_color-as-color)                                                                                                                                       |
| [QuaternaryLabel\_Color](#quaternarylabel_color-as-color)                                                                                                                                        | [ScrollBar\_Color](#scrollbar_color-as-color)                                                                                                                                                   |
| [SecondaryLabel\_Color](#secondarylabel_color-as-color)                                                                                                                                          | [SelectedContentBackground\_Color](#selectedcontentbackground_color-as-color)                                                                                                                   |
| [SelectedControlText\_Color](#selectedcontroltext_color-as-color)                                                                                                                                | [SelectedControl\_Color](#selectedcontrol_color-as-color)                                                                                                                                       |
| [SelectedMenuItemText\_Color](#selectedmenuitemtext_color-as-color)                                                                                                                              | [SelectedMenuItem\_Color](#selectedmenuitem_color-as-color)                                                                                                                                     |
| [SelectedTextBackground\_Color](#selectedtextbackground_color-as-color)                                                                                                                          | [SelectedText\_Color](#selectedtext_color-as-color)                                                                                                                                             |
| [Separator\_Color](#separator_color-as-color)                                                                                                                                                    | [Shadow\_Color](#shadow_color-as-color)                                                                                                                                                         |
| [SystemBlue\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color)   | [SystemBrown\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color) |
| [SystemGray\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color)   | [SystemGreen\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color) |
| [SystemOrange\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color) | [SystemPink\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color)  |
| [SystemPurple\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color) | [SystemRed\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color)   |
| [SystemYellow\_Color](#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color) | [TertiaryLabel\_Color](#tertiarylabel_color-as-color)                                                                                                                                           |
| [TextBackground\_Color](#textbackground_color-as-color-mac-win)                                                                                                                                  | [Text\_Color](#text_color-as-color)                                                                                                                                                             |
| [UnderPageBackground\_Color](#underpagebackground_color-as-color)                                                                                                                                | [UnemphasizedSelectedContentBackground\_Color](#unemphasizedselectedcontentbackground_color-as-color)                                                                                           |
| [UnemphasizedSelectedTextBackground\_Color](#unemphasizedselectedtextbackground_color-as-color)                                                                                                  | [UnemphasizedSelectedText\_Color](#unemphasizedselectedtext_color-as-color)                                                                                                                     |
| [WindowBackground\_Color](#windowbackground_color-as-color)                                                                                                                                      | [WindowFrameText\_Color](#windowframetext_color-as-color)                                                                                                                                       |
| [WindowFrame\_Color](#windowframe_color-as-color)                                                                                                                                                |                                                                                                                                                                                                 |
| [WIN\_ButtonHighlight\_Color](#win_buttonhighlight_color-as-color)                                                                                                                               | [WIN\_CaptionText\_Color](#win_captiontext_color-as-color)                                                                                                                                      |
| [WIN\_Desktop\_Color](#win_desktop_color-as-color)                                                                                                                                               | [WIN\_GradientActiveCaption\_Color](#win_gradientactivecaption_color-as-color)                                                                                                                  |
| [WIN\_GradientInactiveCaption\_Color](#win_gradientinactivecaption_color-as-color)                                                                                                               | [WIN\_Infotext\_Color](#win_infotext_color-as-color)                                                                                                                                            |
| [WIN\_MenubarBackground\_Color](#win_menubarbackground_color-as-color)                                                                                                                           | [WIN\_MenuText\_Color](#win_menutext_color-as-color)                                                                                                                                            |
| [WIN\_WindowBackground\_Color](#win_windowbackground_color-as-color)                                                                                                                             |                                                                                                                                                                                                 |

### Enumerations

| Overview                                    |                                 |
| ------------------------------------------- | ------------------------------- |
| [NSColorSystemEffect](#nscolorsystemeffect) | [NSControlTint](#nscontroltint) |

### Interfaces

| Overview                                                |   |
| ------------------------------------------------------- | - |
| [SystemColorChangeReceiver](#systemcolorchangereceiver) |   |

![High Sierra dynamic colors when selection color is Blue and appearance set to Graphite.](https://3296382369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMJF6lPoRP6_dqCo8LI%2F-LMqtfIEbqNY_0yvxi1w%2F-LMqtohaGxxzXvFhBGkS%2FCapto_Capture%202018-09-20_02-13-39_PM.png?alt=media\&token=1d79d4c0-9c43-4ce9-8183-e9f55b879242)

![Mojave dynamic colors in Light Mode with AccentColor green + SelectionColor blue](https://3296382369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMJF6lPoRP6_dqCo8LI%2F-LMrktFA9VfumW-WC-Gf%2F-LMrkyl2j4KA1NwZdPxe%2FCapto_Capture%202018-09-20_06-14-14_PM.png?alt=media\&token=8772f2d0-8d06-4c0e-8067-63edc9453b35)

![Mojave dynamic colors in Dark Mode with AccentColor green + SelectionColor blue](https://3296382369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMJF6lPoRP6_dqCo8LI%2F-LMrktFA9VfumW-WC-Gf%2F-LMrlFucxsTZUd8t5hx5%2FCapto_Capture%202018-09-20_06-14-00_PM.png?alt=media\&token=2bca9437-a3cd-4976-a688-cdd938d4f981)

![Dynamic system colors under Windows 10 with standard setting (SelectionColor Blue)](https://3296382369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMJF6lPoRP6_dqCo8LI%2F-LMrbWiSG1QtTMl_xaeu%2F-LMrbaeK6yYar-y4jnpA%2FCapto_Capture%202018-09-20_04-24-11_PM.png?alt=media\&token=2d3f57eb-f351-46a4-bcbe-c6df38aa7919)

\


![Windows colors without a direct Mac equivalent ](https://3296382369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMJF6lPoRP6_dqCo8LI%2F-LMrbd0PThKHJ-v-eIkk%2F-LMrbqAg06rB6ms7ml7k%2FCapto_Capture%202018-09-20_04-22-56_PM.png?alt=media\&token=3d957bd3-e60f-4910-bf76-faa1c0b60e09)



## Documentation

### Methods

#### AddSystemEffect(extends c As Color, effect As NSColorAddition.NSColorsystemEffect) As Color

{% hint style="info" %}
macOS only!
{% endhint %}

Returns a new color that represents the current color modified to include the specified visual effect. Available since macOS 10.14. Returns the original color on systems below Mojave or on Windows.

#### BlendColor(extends c As color, BlendColor As Color, Fraction As Double) As Color

Blends the current color with the specified fraction of BlendColor and returns the result as a new color. Uses the natvie NSColor method on macOS and a Xojo calculation on other systems.

#### ChangeAlpha(extends c As Color, alpha As Double/Integer) As Color

Changes the alpha value to the new value and returns the color. Uses alpha between 0.0 and 1.0 for Doubles like macOS or values between 0 and 255 for Integers.

#### Draw(extends c As Color, _optional_ g As Graphics, x As Double, y As Double, w As Double, h As Double)

Draws the color in a rect of the current context. Inverts y if you pass the graphics context. Method without context is macOS only!

#### FillRectangle(extends g as graphics, x as double, y as double, w as double, h as double)

{% hint style="info" %}
macOS only!
{% endhint %}

Fills the specified rectangle of the current graphics context with the currently set FillColor. See [_SetColor_](#setcolor-extends-c-as-color), [_SetFillColor_](#setfillcolor-extends-c-as-color).&#x20;

#### Highlight(extends c As Color, Level As Double) As Color

Creates a new color that represents a blend between the current color and the highlight color. On Windows multiplies c with [_Highlight\_Color_](#highlight_color-as-color).

#### MultiplyColor(extends c As Color, Level As Double = 1.0) As Color

Multiplies the current color with the specified fraction of MultiplyColor and returns the result as a new color.

#### RegisterForSystemColorChangeNotification(Receiver As NSColorAddition.SystemColorChangeReceiver)

Allows a control that incorporates the SystemColorChangeReceiver interface to register for system color changes. Auto-unregisters (no need to unregister the control).&#x20;

{% hint style="warning" %}
On macOS, changes of Dark Mode trigger a refresh of all controls automatically, as well as changing the tint in eralier macOS versions. A change of the selection color anyhow does not trigger an update. When a control registers on this method, the interface’s SystemColorsChanged method will be called even on selection changes.\
\
On current Windows, changes of the Windows Dark Mode are not registered. Changes to system color palette and high contrast modes are.
{% endhint %}

#### ScrubberTexturedBackgroundColor As Ptr

{% hint style="info" %}
macOS only!\
Please note that macOS has Ptrs like this for all the dynamic system colors.
{% endhint %}

The patterned color to use for the background of a scrubber control. Available since macOS 10.12. Nil below. Has no Xojo conversion.

#### SetColor(extends c As Color)

{% hint style="info" %}
macOS only!
{% endhint %}

Sets the color to be used in subsequent cgcontext draw commands.&#x20;

#### SetFillColor(extends c As Color)

{% hint style="info" %}
macOS only!
{% endhint %}

Sets the color to be used as fill color in subsequent cgcontext draw commands.

#### SetFillColor(extends g As Graphics, value As Ptr)

{% hint style="info" %}
macOS only!
{% endhint %}

Sets the color to be used as fill color in subsequent cgcontext draw commands. Useful for the NSColorPtrs – see [ScrubberTexturedBackgroundColor](#scrubbertexturedbackgroundcolor-as-ptr).

#### SetStrokeColor(extends c As Color)

{% hint style="info" %}
macOS only!
{% endhint %}

Sets the color to be used as stroke color in subsequent cgcontext draw commands.

#### Shadow(extends c As Color, Level As Double) As Color

Creates a new color that represents a blend between the current color and the Shadow color. On Windows multiplies c with Shadow\_Color.

#### SystemVersionIsAtLeast(majorversion As Integer, minorversion A sInteger = 0, patchversion As Integer = 0) As Boolean

Returns a Boolean that indicates if the current system version is equal or higher than the specified version. Compares the Service Pack Major Number as Patchversion on Windows. A check for Mojave would be

```
Dim b as Boolean = SystemVersionIsAtLeast(10, 14)
```

{% hint style="warning" %}
On Windows, thies method returns the result against the system the app is manifested for. If you do not use a valid Windows 10 manifest, this method will check against Windows 8 minor version 2.
{% endhint %}

### Properties

{% hint style="info" %}
See also the hint at the Overview. \
These, with the exception of Current\_Tint, are all read-only-properties of type Color. They can change their values whenever the user changes a system color or Dark Mode, so use them directly in the context of a Paint event. Do not cache them longer than one redraw cycle.
{% endhint %}

#### AlternateSelectedControlText\_Color As Color

The color to use for text in a selected control. (Mac + Win)\
Returns [_SelectedControlText\_Color_](#selectedcontroltext_color-as-color) on Windows.

#### AlternatingContentBackground\_Color0 As Color

The base color to use for alternating content, typically found in table views and collection views. (Mac + Win)\
Returns _ColorActiveBorder_ on Windows.

{% hint style="info" %}
If you want a table to color its rows rather blueish on standard Windows systems, use _WIN\_GradientActiveCaption\_Color_ and _WIN\_GradientInactiveCaptionColor_ instead of Alternating…Color0 and 1.
{% endhint %}

#### AlternatingContentBackground\_Color1 As Color

The alternating color to use for alternating content, typically found in table views and collection views. (Mac + Win)\
Returns _ColorInactiveBorder_ on Windows.

#### Clear\_Color As Color

An invisible color. (All platforms)

#### ControlAccent\_Color As Color

The user's current accent color preference. (Mac + Win)\
Available since macOS 10.14. Makes a fallback to controlTintColor(CurrentControlTint) on systems below.\
Returns [_DisabledControlText\_Color_](#disabledcontroltext_color-as-color) on Windows.

#### ControlBackground\_Color as Color&#x20;

The color to use for the background of large controls, such as scroll views or table views. (Mac + Win)\
Returns [_Highlight\_Color_](#highlight_color-as-color) on Windows.

#### ControlText\_Color As Color

The color to use for text on enabled controls. (Mac + Win)\
Returns _ColorButtonText_ on Windows.

#### Control\_Color As Color

The color to use for the flat surfaces of a control. (Mac + Win)\
Returns _ColorButtonFace_ on Windows.

#### CurrentControl\_Tint As NSControlTint

{% hint style="info" %}
macOS only!
{% endhint %}

The current system control tint color.

#### DisabledControlText\_Color As Color

The color to use for text on disabled controls. (Mac + Win)\
Returns _ColorInactiveCaption_ on Windows.

#### FindHighlight\_Color As Color

The highlight color to use for the bubble that shows inline search result values. (Mac + Win)\
&#xNAN;_**Available since macOS 10.13**_. Makes a fallback to HighlightColor below.\
Returns _ColorInfoBackground_ on Windows.

#### Grid\_Color As Color

The color to use for the optional gridlines, such as those in a table view. (Mac + Win)\
Returns _ColorButtonShadow_ on Windows.

#### HeaderText\_Color As Color

The color to use for text in header cells in table views and outline views. (Mac + Win)\
Returns [_Text\_Color_](#text_color-as-color) on Windows.

#### Highlight\_Color As Color

The color to use as a virtual light source on the screen. (Mac + Win)\
Returns _Color3DLight_ on Windows.

{% hint style="info" %}
Do not confuse Hightlight\_Color with Xojo’s HighlightColor where this represents rather the Accent or SelectionColor.
{% endhint %}

#### KeyboardFocusIndicator\_Color As Color

The color to use for the keyboard focus ring around controls. (Mac + Win)\
Returns _ColorMenuHighlight_ on Windows.

#### Label\_Color As Color

The color to use for text labels. (Mac + Win)\
Returns _Text\_Color_ with an alpha of .85 on Windows.

#### Link\_Color As Color

The color to use for links. (Mac + Win)\
Returns _HotLightColor_ on Windows.

#### PlaceholderText\_Color As Color

The color to use for placeholder text in controls or text views. (Mac + Win)\
Returns _ColorDisabledText_ on Windows.

#### QuaternaryLabel\_Color As Color

The quaternary color to use for text labels. (All platforms)\
Returns _Text\_Color.ChangeAlpha(0.35)_ on non-Mac.

#### ScrollBar\_Color As Color

The system color used for scroll “bars”—that is, for the groove in which a scroller’s knob moves (Mac + Win). _**Deprecated**_ on macOS 10.14. Use an NSScroller instead.

#### SecondaryLabel\_Color As Color

The secondary color to use for text labels. (All platforms)\
Returns _Text\_Color.ChangeAlpha(0.75)_ on non-Mac.

#### SelectedContentBackground\_Color As Color

The color to use for the background of selected and emphasized content. (Mac + Win)\
&#xNAN;_**Available**_ since macOS 10.14. Makes a fallback to _SelectedControl\_Color_ below.\
Returns [_SelectedMenuItem\_Color_](#selectedmenuitem_color-as-color) on Windows.

#### SelectedControlText\_Color As Color

The color to use for text in a selected control—that is, a control being clicked or dragged. (Mac + Win)\
Returns _ColorHighlightText_ on Windows.

#### SelectedControl\_Color As Color

The color to use for the face of a selected control—that is, a control that has been clicked or is being dragged. (Mac + Win)\
Returns _ColorHighlightControl_ on Windows.

#### SelectedMenuItemText\_Color As Color

The color to use for the text in selected menu items. (Mac + Win)\
Returns _ColorActiveCaption_ on Windows.

#### SelectedMenuItem\_Color As Color

The color to use for the face of selected menu items. (Mac + Win). \
&#xNAN;_**Deprecated**_ on macOS 10.14. Use an NSVisualEffectView instead.\
Returns _ColorMenuHighlight_ on Windows.

#### SelectedTextBackground\_Color As Color

The color to use for the background of selected text. (Mac + Win)\
Returns [_SelectedMenuItem\_Color_](#selectedmenuitem_color-as-color) on Windows.

#### SelectedText\_Color As Color

The color to use for selected text. (Mac + Win)\
Returns _ColorActiveCaption_ on Windows.

#### Separator\_Color As Color

The color to use for separators between different sections of content. (Mac + Win)\
&#x20;_**Available**_ since macOS 10.14. Makes a fallback to _Grid\_Color_ on systems below.\
Returns _ColorMDIBackground_ on Windows.

#### Shadow\_Color As Color

The color to use for virtual shadows cast by raised objects on the screen. (Mac + Win)\
Returns _Color3DDarkShadow_ on Windows.

#### SystemBlue\_Color, SystemBrown\_Color, SystemGray\_Color, SystemGreen\_Color, SystemOrange\_Color, SystemPink\_Color, SystemPurple\_Color, SystemRed\_Color, SystemYellow\_Color As Color

A color for the respectively named color that automatically adapts to vibrancy and accessibility settings. (all platforms). \
Returns the normal color of that name on non-Mac systems, with the exception of _Color.Magenta_ for _SystemPink\_Color_.

#### TertiaryLabel\_Color As Color

The tertiary color to use for text labels. (All platforms)\
Returns _Text\_Color.ChangeAlpha(0.55)_ on non-Mac systems.

#### TextBackground\_Color As Color&#x20;

The color to use for the background area behind text. (Mac + Win)\
Returns _Color\_WindowBackground_ on Windows.

#### Text\_Color As Color

The color to use for plain text. (Mac + Win)\
Returns ColorWindowText on Windows.

#### UnderPageBackground\_Color As Color

The color to use in the area beneath your window's views. (Mac + Win)\
Returns _ColorMDIBackground_ on Windows.

#### UnemphasizedSelectedContentBackground\_Color As Color

The color to use for selected and unemphasized content. (Mac + Win)\
&#xNAN;_**Available**_ since macOS 10.14. Makes a fallback to _ControlContent\_Color_ below.\
Returns [_SelectedContentBackground\_Color_](#selectedcontentbackground_color-as-color) on Windows.

#### UnemphasizedSelectedTextBackground\_Color As Color

The color to use for the text background in an unemphasized context. (Mac + Win)\
&#xNAN;_**Available**_ since macOS 10.14. Makes a fallback to _SelectedTextBackground\_Color_ below.\
Returns [_SelectedTextBackground\_Color_](#selectedtextbackground_color-as-color) on Windows.

#### UnemphasizedSelectedText\_Color As Color

The color to use for selected text in an unemphasized context. (Mac + Win)\
&#xNAN;_**Available**_ since macOS 10.14. Makes a fallback to _SelectedText\_Color_ on systems below.\
Returns [_SelectedText\_Color_](#selectedtext_color-as-color) on Windows.

#### WindowBackground\_Color As Color

The color to use for the window background. (Mac + Win)

{% hint style="warning" %}
Please note that the system color for the window background on standard Windows 10 for example is white, not the light gray color that Xojo uses for the standard background.
{% endhint %}

#### WindowFrameText\_Color As Color

The color to use for text in a window's frame. (Mac + Win)\
Returns _ColorWindowText_ on Windows.

#### WindowFrame\_Color As Color

The system color used for window frames, except for their text. (Mac + Win). \
&#xNAN;_**Deprecated**_ on macOS 10.14. Use an NSVisualEffectView with the NSVisualEffectMaterialTitlebar material instead.\
Returns _ColorWindowFrame_ on Windows.

{% hint style="info" %}
The following properties are Window color properties that could not easily be mapped to existing NSColor Mac properties. You can use them xplatform as well.
{% endhint %}

#### WIN\_ButtonHighlight\_Color As Color

Highlight color for three-dimensional display elements (for edges facing the light source.) (Win + Mac)\
Returns [_Highlight\_Color_](#highlight_color-as-color) on Mac.

#### WIN\_CaptionText\_Color As Color

Text in caption, size box, and scroll bar arrow box. (Win + Mac)\
Returns [_ControlText\_color_](#controltext_color-as-color) on Mac.

#### WIN\_Desktop\_Color As Color

The desktop color. As this is usually a picture, often returns black. (WIn + Mac)\
Returns [_UnderPageBackground\_Color_](#underpagebackground_color-as-color) on Mac.

#### WIN\_GradientActiveCaption\_Color As Color

Right side color in the color gradient of an active window's title bar. Also good for Alternating Content together with WIN\_InactiveGradientColor (Win + Mac)\
Returns [_AlternatingContentBackground\_Color0_](#alternatingcontentbackground_color0-as-color) on Mac.

#### WIN\_GradientInactiveCaption\_Color As Color

Left side color in the color gradient of an inactive window's title bar. Also good for Alternating Content together with WIN\_ActiveGradientColor (Win + Mac)\
Returns [_AlternatingContentBackground\_Color1_](#alternatingcontentbackground_color1-as-color) on Mac.

#### WIN\_Infotext\_Color As Color

Text color for tooltip controls. (Win + Mac)\
Returns [_Label\_Color_](#label_color-as-color) on Mac.

#### WIN\_MenubarBackground\_Color As Color

The background color for the menu bar when menus appear as flat menus. (Win + Mac)\
Returns [_Control\_Color_](#control_color-as-color) on Mac.

#### WIN\_MenuText\_Color As Color

Text color in Menus (Win + Mac)\
Returns [_Text\_Color_](#text_color-as-color) on Mac.

#### WIN\_Menu\_Color As Color

Windows menu color.\
Returns [ControlBackground\_Color](#controlbackground_color-as-color) on Mac.

### Enumerations

#### NSColorSystemEffect

Values for the mac-only [_AddSystemEffect_](#addsystemeffect-extends-c-as-color-effect-as-nscoloraddition-nscolorsystemeffect-as-color) method:

| Value       | Definition                                               |
| ----------- | -------------------------------------------------------- |
| None        | no additional effect                                     |
| Pressed     | The color that indicates the item was pressed.           |
| DeepPressed | The color that indicates the item received a deep press. |
| Disabled    | The color that indicates the item is disabled.           |
| RollOver    | The color that indicates the mouse rolled over the item. |

#### NSControlTint

Values for the **deprecated** [_CurrentControl\_Tint_](#currentcontrol_tint-as-nscontroltint) property. Necessary for the fallback on older Mac systems than Mojave. Values:

| Value    | Definition                        |
| -------- | --------------------------------- |
| Default  | The current default tint setting. |
| Blue     | Aqua control tint.                |
| Graphite | Graphite control tint.            |
| Clear    | Clear control tint.               |

### Interfaces

#### SystemColorChangeReceiver

Any class incorporating this interface can use the [_RegisterForSystemColorChangeNotification_](#registerforsystemcolorchangenotification-receiver-as-nscoloraddition-systemcolorchangereceiver) method. If done so, on each system color change the instances’

**SystemColorChanged**()

method will be triggered. Use it to update custom, mode-dependend content.

