UIElement.HighContrastAdjustment Свойство

Определение

Пространство имен:

Windows.UI.Xaml

Возвращает или задает значение, указывающее, настраивает ли платформа визуальные свойства элемента автоматически при включении тем высокой контрастности.

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

Значение свойства

ElementHighContrastAdjustment

Значение перечисления, указывающее, настраивает ли платформа визуальные свойства элемента автоматически при включении тем высокой контрастности. Значение по умолчанию — приложения.

Требования к Windows

Семейство устройств	Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v4.0)

Комментарии

Значение свойства наследуется. Если задано значение Application, корректировка будет зеркально отображать значение свойства ApplicationHighContrastAdjustment. Задание свойства ApplicationHighContrastAdjustment значение None будет эффективно отключать его для всего пользовательского интерфейса в приложении. Его можно выборочно включить для UIElement, явно задав значение авто.
Если задано значение авто, платформа автоматически применяет следующие корректировки к текстовым элементам XAML, а тема высокой контрастности включена:

• Цвет переднего плана текста игнорируется. Текст цветируется с помощью цвета текста с высокой контрастностью системы или отключенного цвета, если в родительском элементе управления control, где IsEnabled = False.
• Непрозрачный прямоугольник отображается непосредственно за текстом для обеспечения высокой контрастности.
• Ненулевых значений для непрозрачности игнорируются. Элемент и его дочерние элементы будут отображаться, как если бы они имели непрозрачность 1.0.

На следующих изображениях показано различие между авто (значением приложения по умолчанию) и None:

Можно задать HighContrastAdjustment = None в UIElement, а затем иметь HighContrastAdjustment = Auto на одном из его потомков. Однако платформа не гарантирует, что потомок будет полностью непрозрачным, если непрозрачность применяется к любому из его предков.