Glyphs.IsColorFontEnabled Property

Definition

Gets or sets a value that determines whether font glyphs that contain color layers, such as Segoe UI Emoji, are rendered in color.

Equivalent WinUI property: Microsoft.UI.Xaml.Documents.Glyphs.IsColorFontEnabled.

public:
 property bool IsColorFontEnabled { bool get(); void set(bool value); };
bool IsColorFontEnabled();

void IsColorFontEnabled(bool value);
public bool IsColorFontEnabled { get; set; }
var boolean = glyphs.isColorFontEnabled;
glyphs.isColorFontEnabled = boolean;
Public Property IsColorFontEnabled As Boolean

Property Value

Boolean

true if color glyphs show in color; otherwise, false. The default is true.

Remarks

Starting in Windows 10, you can set the IsColorFontEnabled property on the Glyphs element. Prior to Windows 10, you could enable or disable color fonts only on text controls, like TextBlock.

Color fonts in Windows

Starting in Windows 8.1, fonts can include multiple colored layers for each glyph. For example, the Segoe UI Emoji font defines color versions of the Emoticon and other Emoji characters. By default, the IsColorFontEnabled property is true and fonts with these additional layers are rendered in color.

In Windows 8, Extensible Application Markup Language (XAML) text controls don't render multi-color fonts in color. When an app that was compiled for Windows 8 is recompiled for Windows 8.1 or later, color rendering of multi-color fonts is enabled by default. Some glyphs in multi-color fonts have different layout metrics when rendered in color. This could cause different layout in apps when they are recompiled for Windows 8.1 or later. To retain the Windows 8 behavior when your app is recompiled, set IsColorFontEnabled to false.

Applies to