UIElement.HighContrastAdjustment Eigenschaft

Definition

Namespace:

Windows.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.

Windows-Anforderungen

Gerätefamilie	Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Hinweise

Der Wert der -Eigenschaft wird geerbt. Wenn diese Einstellung auf Anwendung festgelegt ist, Spiegel, was für die HighContrastAdjustment-Eigenschaft der Anwendung festgelegt ist. Wenn Sie die HighContrastAdjustment-Eigenschaft der Anwendung auf None festlegen, wird sie effektiv für alle Benutzeroberfläche in der Anwendung deaktiviert. Es kann selektiv für ein UIElement aktiviert werden, indem der Wert explizit auf Auto festgelegt wird.
Bei Festlegung auf Auto 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 oder der deaktivierten Farbe gefärbt, wenn er sich in einem übergeordneten Steuerelement befindet, wobei IsEnabled = "False" ist.
• Ein undurchsichtiges Rechteck wird unmittelbar hinter dem Text gerendert, um ein hohes Kontrastverhältnis zu erzwingen.
• Werte ungleich 0 (Null) für Deckkraft werden ignoriert. Das Element und seine untergeordneten Elemente werden so angezeigt, als hätten sie eine Deckkraft von 1,0.

Es ist möglich, HighContrastAdjustment = None für ein UIElement festzulegen und dann HighContrastAdjustment = Auto für eines seiner Nachfolger zu verwenden. Das Framework garantiert jedoch nicht, dass der Nachfolger vollständig undurchsichtig ist, wenn eine Deckkraft auf einen seiner Vorgänger angewendet wird.