> For the complete documentation index, see [llms.txt](https://xojo.gitbook.io/add-ons/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xojo.gitbook.io/add-ons/cstruecolors/changelog.md).

# Changelog

## 1.2.0

**Release date:** Oct 12 2018

### New

* `[mac]` [VisualEffectViews](/add-ons/cstruecolors/documentation/appkitaddition/visualeffectview.md) added as custom controls to [AppKitAddition](/add-ons/cstruecolors/documentation/appkitaddition.md).

### Fixed

* `[win + mac]` [WindowBackground\_Color](/add-ons/cstruecolors/documentation/nscoloraddition.md#windowbackground_color-as-color) is reset now too during a system color change.
* `[Demo]` Windows are now registered at [NSColorAddition](/add-ons/cstruecolors/documentation/nscoloraddition.md) as [SystemColorChangeReceivers](/add-ons/cstruecolors/documentation/nscoloraddition.md#registerforsystemcolorchangenotification-receiver-as-nscoloraddition-systemcolorchangereceiver) so they correctly change their custom background color.

## 1.1.1

**Release date:** Oct 11 2018

### **New**

* `[win + mac]` Dynamic system colors are cached now. Both systems install a watcher to invalidate the colors in case of a color palette / Appearance change, otherwise their values will be retrieved from the interal cache. Therefore better performance.
* `[win]` Uses the [Color.BlendColor](/add-ons/cstruecolors/documentation/nscoloraddition.md#blendcolor-extends-c-as-color-blendcolor-as-color-fraction-as-double-as-color) method for an approximation of systemColor.Colors under Windows – which means there are not that fully saturated [systemRed\_Colo](/add-ons/cstruecolors/documentation/nscoloraddition.md#systemblue_color-systembrown_color-systemgray_color-systemgreen_color-systemorange_color-systempink_color-systempurple_color-systemred_color-systemyellow_color-as-color)r etc. on Windows too.
* `[all]` The former blendColor implementation for Windows and Linux now exists as xplatform [MultiplyColor](/add-ons/cstruecolors/documentation/nscoloraddition.md#multiplycolor-extends-c-as-color-level-as-double-1-0-as-color) method – because that is basically what it did.
* `[mac + win]` several extension methods for setting images and icons in PushButtons, RadioButtons, Popupmenus and similar features.
* `[mac + win]` Many Pushbutton features extended to work on RadioButtons too.
* `[mac]` [AppKitAddition](/add-ons/cstruecolors/documentation/appkitaddition.md) now includes methods for PushButton, RadioButton, PopupMenu, Window, MenuItem and SegmentedControl.
* `[win]` [User32Addition](/add-ons/cstruecolors/documentation/user32addition.md) supports many controls- and windows features in conjunction with images under Windows as a sidekick for AppKitAddition.

### Fixed

* `[win + linux]` [Color.BlendColor](/add-ons/cstruecolors/documentation/nscoloraddition.md#blendcolor-extends-c-as-color-blendcolor-as-color-fraction-as-double-as-color) brings a result similar to the native macOS function by a Xojo method now.&#x20;
* `[win]` [WindowBackground\_Color](/add-ons/cstruecolors/documentation/nscoloraddition.md#windowbackground_color-as-color) now returns white on Windows 10 which is the correct window background color, not the light gray color that Xojo uses.
* `[all]` Win\_WindowBackground\_Color was removed because of the upper change and replaced by [Win\_Menu\_Color](/add-ons/cstruecolors/documentation/nscoloraddition.md#win_menu_color-as-color).
* `[win]` [RegisterForSystemColorChangeNotification](/add-ons/cstruecolors/documentation/nscoloraddition.md#registerforsystemcolorchangenotification-receiver-as-nscoloraddition-systemcolorchangereceiver) is now useful on Windows too, but only for system color palette and High Contrast Mode changes, not for Windows Dark Mode currently.

{% hint style="warning" %}
Please note that currently Dark Mode and changes to and from it under Windows are not supported. It is rumored that Microsoft will change this in a coming Windows 10 release.
{% endhint %}

* `[win]` [SystemVersionIsAtLeast](/add-ons/cstruecolors/documentation/nscoloraddition.md#systemversionisatleast-majorversion-as-integer-minorversion-a-sinteger-0-patchversion-as-integer-0-as-boolean) works now for Windows too but checks against the system the app is manifested for.
* `[win]` 64 bit compatibility
* `[mac]` Removal of unused Windows parameters.

### Known problems

* `[win]` The controls window sometimes crashes during opening on Windows. This seems to be a beta bug caused by getting the ICON handle of an image for a repeated time.

## 1.0.1 - 2018-10-01

### Fixed

* Added a pragma to make the project work with Xojo < 2018r3.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xojo.gitbook.io/add-ons/cstruecolors/changelog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
