UIElement.HighContrastAdjustment Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für