Поделиться через


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

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

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

Требования к 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, равным auto.Пример кнопок с параметром HighContrastAdjustment, равным none.

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

Применяется к