UIElement.HighContrastAdjustment Propriété

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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é

ElementHighContrastAdjustment

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 Control où IsEnabled = « 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.

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 à

Produit	Versions
WinRT	Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Partager via