UIElement.HighContrastAdjustment 属性

定义

获取或设置一个值,该值指示框架是否在启用高对比度主题时自动调整元素的视觉属性。

public:
 property ElementHighContrastAdjustment HighContrastAdjustment { ElementHighContrastAdjustment get(); void set(ElementHighContrastAdjustment value); };
ElementHighContrastAdjustment HighContrastAdjustment();

void HighContrastAdjustment(ElementHighContrastAdjustment value);
public ElementHighContrastAdjustment HighContrastAdjustment { get; set; }
var elementHighContrastAdjustment = uIElement.highContrastAdjustment;
uIElement.highContrastAdjustment = elementHighContrastAdjustment;
Public Property HighContrastAdjustment As ElementHighContrastAdjustment

属性值

枚举的一个值,该值指示框架是否在启用高对比度主题时自动调整元素的视觉属性。 默认值为 Application

Windows 要求

设备系列
Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

继承 属性的值。 设置为“应用程序”时,调整将镜像为应用程序的HighContrastAdjustment 属性设置的内容。 将 应用程序的HighContrastAdjustment 属性设置为 None 将有效地禁用应用程序中的所有 UI。 通过将值显式设置为 “自动”,可以有选择地为 UIElement 启用它。
设置为 “自动”时,框架会在启用高对比度主题时自动将以下调整应用于 XAML 的文本元素:

  • 忽略文本的前景色。 当在 IsEnabled = “False” 的父控件中时,使用系统的高对比度文本颜色或禁用颜色对文本进行着色。
  • 文本后面立即呈现一个不透明的矩形,以强制实施高对比度。
  • 忽略 Opacity 的非零值。 元素及其子元素的不透明度为 1.0。

可以在 UIElement 上设置 HighContrastAdjustment = None,然后在其某个后代上设置 HighContrastAdjustment = Auto。 但是,如果对其任何上级应用了不透明性,框架并不能保证后代将完全不透明。

适用于