UIElement.HighContrastAdjustment Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind.

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 Aufzählung, 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. Bei Festlegung auf Application spiegelt die Anpassung das für die ApplicationHighContrastAdjustment-Eigenschaft festgelegte Einstellung wieder. Das Festlegen der ApplicationHighContrastAdjustment-eigenschaft auf None deaktiviert sie effektiv für alle Ui in der Anwendung. Sie kann für ein UIElement selektiv aktiviert werden, indem der Wert explizit auf Auto-festgelegt wird.
Bei Festlegung auf Auto-wendet das Framework automatisch die folgenden Anpassungen an 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 für hohen Kontrast des Systems oder der deaktivierten Farbe in einem übergeordneten Steuerelement, wobei IsEnabled = "False" gefärbt ist.
• Ein undurchsichtiges Rechteck wird unmittelbar hinter dem Text gerendert, um ein hohes Kontrastverhältnis zu erzwingen.
• Nicht-Nullwerte für Deckkraft- werden ignoriert. Das Element und die untergeordneten Elemente werden so angezeigt, als hätten sie eine Deckkraft von 1,0.

Die folgenden Bilder zeigen den Unterschied zwischen Auto- (dem Standardwert Application) und None:

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