UIElement.HighContrastAdjustment Propriété

Définition

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é

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.

Remarques

La valeur de la propriété est héritée. Quand la valeur est définie 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 Nonel’application sur permet de la désactiver efficacement 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 alors 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 et d’avoir HighContrastAdjustment = Auto ensuite 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.

S’applique à