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 des 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 des 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’elle est définie sur application l’ajustement reflète ce qui est défini pour la propriété's HighContrastAdjustment de l’application . La définition de la propriété Application's HighContrastAdjustment sur Aucun le désactive efficacement pour toute l’interface utilisateur de l’application. Elle peut être activée de manière sélective pour un UIElement en définissant explicitement la valeur sur automatique.
Lorsqu’elle est définie sur automatique, 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 lorsqu’un contrôle parent ControlIsEnabled = « False ».
  • Un rectangle opaque est affiché immédiatement derrière le texte pour appliquer un rapport de contraste élevé.
  • Les valeurs non nulles pour d’opacité sont ignorées. L’élément et ses enfants apparaissent comme s’ils avaient une opacité de 1,0.

Les images suivantes montrent la différence entre automatique (valeur par défaut Application) et Aucun:

Exemple de boutons avec HighContrastAdjustment défini sur automatique.Exemple de boutons avec HighContrastAdjustment défini sur aucun.

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 la descendente sera entièrement opaque si une opacité est appliquée à l’un de ses ancêtres.

S’applique à