UIElement.HighContrastAdjustment Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient ou définit une valeur qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque les thèmes à contraste élevé sont activés.

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

Valeur de propriété

ElementHighContrastAdjustment

Valeur de l’énumération qui indique si l’infrastructure ajuste automatiquement les propriétés visuelles de l’élément lorsque les thèmes à contraste élevé sont activés. La valeur par défaut est Application.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Remarques

La valeur de la propriété est héritée. Lorsqu’il est défini sur Application, l’ajustement miroir ce qui est défini pour la propriété HighContrastAdjustment de l’application. La définition de la propriété HighContrastAdjustment de l’application sur None désactive efficacement cette propriété pour toute l’interface utilisateur de l’application. Il peut être activé de manière sélective pour un UIElement en définissant explicitement la valeur sur Auto.
Lorsqu’elle est définie sur Auto, l’infrastructure applique automatiquement les ajustements suivants aux éléments de texte XAML, tandis qu’un thème à contraste élevé est activé :

• La couleur de premier plan sur le texte est ignorée. Le texte est coloré à l’aide de la couleur de texte à contraste élevé du système ou de la couleur désactivée dans un contrôle parent où IsEnabled = « False ».
• Un rectangle opaque est rendu immédiatement derrière le texte pour appliquer un taux de contraste élevé.
• Les valeurs non nulles pour opacité sont ignorées. L’élément et ses enfants apparaissent comme s’ils avaient une opacité de 1.0.

Il est possible de définir HighContrastAdjustment = None sur un UIElement, puis d’avoir HighContrastAdjustment = Auto sur l’un de ses descendants. Toutefois, le framework ne garantit pas que le descendant sera entièrement opaque si une opacité est appliquée à l’un de ses ancêtres.