Dark Mode

From Xojo Documentation

Revision as of 15:32, 18 January 2019 by PLefebvre (talk | contribs) (See Also)
Supports Dark Mode Shared Build Setting

Xojo 2018r3 adds support for Dark Mode on macOS Mojave 10.14. To enable Dark Mode support for your app, turn the "Supports Dark Mode" property on the Shared Build Settings. For new projects, "Supports Dark Mode" defaults to ON. For existing projects, it defaults to "OFF".

Default Colors

There are some subtle changes to how default colors work.

  • Controls whose text defaults to Solid Black (&c00000000) will automatically use the system's Text Color (except Label, see below), which changes depending on Light or Dark mode.
  • Controls whose background color defaults to Solid White (&cFFFFFF00) will automatically use the system's Text Background Color, which changes depending on Light or Dark Mode.
  • When painting to a Graphics context (such as in Canvas.Paint), TextColor returns the system Text Color, FillColor returns the system's Window Fill Color and FrameColor now uses the system's Control Color.
  • Labels whose TextColor is set to Solid Black (&c000000) will automatically use the system's Label Color so they automatically match the captions on Checkboxes and Radio buttons and change depending on light/dark mode.
  • If you do not want Xojo to automatically swap these colors for you, instead choose an Off-White or Off-Black color, such as &c00000001 or &cFFFFFF01. These will be indistinguishable from Solid Black and Solid White and ignore by Xojo.

Methods and Events

There is a new global method called IsDarkMode which returns True if the system is running in Dark Mode on macOS Mojave and the app has Supports Dark Mode set to ON. It currently always returns False on Windows and Linux. Use this to detect Dark Mode for situations when you have to manually adjust colors, graphics or icons yourself.

The Application.AppearanceChanged is called when the user switches between light and dark modes or when the accent color changes. You can use this to tell your UI to update or redraw as necessary.

Control Differences

Due to changes made by Apple, controls in Mojave dark mode are translucent. Because of this it is recommended you avoid overlapping controls in your layouts.

Because of the translucent controls you may find redrawing occurs differently in some situations. If you are not seeing redraws when you expect, try calling the Refresh method instead of Invalidate.

Window Backgrounds

Windows with custom background colors do not automatically change the color for Dark Mode. You will have to adjust the color in your code when IsDarkMode returns True.

See Also