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.
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
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.
Hinweise
Der Wert der Eigenschaft wird geerbt. Wenn sie auf Application die Anpassung festgelegt ist, wird die Einstellung für die HighContrastAdjustment-Eigenschaft der Anwendung gespiegelt. Durch Festlegen der HighContrastAdjustment-Eigenschaft der Anwendung wird None sie effektiv für alle Ui-Elemente in der Anwendung deaktiviert. Sie kann für ein UIElement selektiv aktiviert werden, indem der Wert explizit auf Autofestgelegt 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 gefärbt, wobei IsEnabled = "False" ist.
- Ein undurchsichtiges Rechteck wird unmittelbar hinter dem Text gerendert, um ein hohes Kontrastverhältnis zu erzwingen.
- Nicht-Nullwerte für Opacity werden ignoriert. Das Element und die untergeordneten Elemente werden so angezeigt, als hätten sie eine Deckkraft von 1,0.
Es ist möglich, für ein UIElement und dann HighContrastAdjustment = Auto auf einem seiner Nachfolger festzulegenHighContrastAdjustment = None. Das Framework garantiert jedoch nicht, dass der Absteigende vollständig undurchsichtig ist, wenn eine Deckkraft auf einen seiner Vorfahren angewendet wird.