UIElement.HighContrastAdjustment Propriété
Définition
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.
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 None
l’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.