UIElement.HighContrastAdjustment UIElement.HighContrastAdjustment UIElement.HighContrastAdjustment UIElement.HighContrastAdjustment Property

Definition

Gets or sets a value that indicates whether the framework automatically adjusts the element's visual properties when high contrast themes are enabled.

public : ElementHighContrastAdjustment HighContrastAdjustment { get; set; }
ElementHighContrastAdjustment HighContrastAdjustment();

void HighContrastAdjustment(ElementHighContrastAdjustment highcontrastadjustment);
public ElementHighContrastAdjustment HighContrastAdjustment { get; set; }
Public ReadWrite Property HighContrastAdjustment As ElementHighContrastAdjustment
Property Value

A value of the enumeration that indicates whether the framework automatically adjusts the element's visual properties when high contrast themes are enabled. The default is Application.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Remarks

The value of the property is inherited. When set to Application the adjustment will mirror what is set for the Application 's HighContrastAdjustment property. Setting the Application 's HighContrastAdjustment property to None will effectively disable it for all UI in the application. It can be selectively enabled for a UIElement by explicitly setting the value to Auto.
When set to Auto, the framework automatically applies the following adjustments to XAML's text elements while a high contrast theme is enabled:

  • The foreground color on text is ignored. The text is colored using either the system’s high contrast text color or the disabled color when in a parent Control where IsEnabled = "False".
  • An opaque rectangle is rendered immediately behind the text to enforce a high contrast ratio.
  • Non-zero values for Opacity are ignored. The element and it's children will appear as if they had an opacity of 1.0.

It is possible to set HighContrastAdjustment = None on a UIElement and then have HighContrastAdjustment = Auto on one of its descendants. However, the framework does not guarantee that the descendent will be fully opaque if an opacity is applied on any of its ancestors.