UIElement.HighContrastAdjustment Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft einen Wert ab, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind, oder legt diesen fest.

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

Eigenschaftswert

ElementHighContrastAdjustment

Ein Wert der Enumeration, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind. Der Standardwert ist Application.

Hinweise

Der Wert der Eigenschaft wird geerbt. Wenn sie auf Application die Anpassung festgelegt ist, Spiegel, was für die HighContrastAdjustment-Eigenschaft der Anwendung festgelegt ist. Wenn Sie die HighContrastAdjustment-Eigenschaft der Anwendung auf festlegen, None wird sie effektiv für die gesamte Benutzeroberfläche in der Anwendung deaktiviert. Es kann selektiv für ein UIElement aktiviert werden, indem der Wert explizit auf Autofestgelegt wird.

Wenn auf Autofestgelegt ist, wendet das Framework automatisch die folgenden Anpassungen auf die Textelemente von XAML an, während ein Design mit hohem Kontrast aktiviert ist:

• Die Vordergrundfarbe für Text wird ignoriert. Der Text wird entweder mit der Textfarbe mit hohem Kontrast des Systems oder der deaktivierten Farbe eingefärbt, wenn in einem übergeordneten SteuerelementisEnabled = "False" verwendet wird.
• Ein undurchsichtiges Rechteck wird direkt hinter dem Text gerendert, um ein hohes Kontrastverhältnis zu erzwingen.
• Werte ungleich null für Deckkraft werden ignoriert. Das Element und die untergeordneten Elemente werden so angezeigt, als hätten sie eine Deckkraft von 1,0.

Es ist möglich, auf einen UIElement festzulegen und dann auf einen seiner Nachkommen zu HighContrastAdjustment = None habenHighContrastAdjustment = Auto. Das Framework garantiert jedoch nicht, dass der Abstamm vollständig undurchsichtig ist, wenn eine Deckkraft auf einen seiner Vorgänger angewendet wird.