# 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. 
* `[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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.