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.
На следующих изображениях показано различие между
Можно задать HighContrastAdjustment = None в UIElement, а затем иметь HighContrastAdjustment = Auto на одном из его потомков. Однако платформа не гарантирует, что потомок будет полностью непрозрачным, если непрозрачность применяется к любому из его предков.