UIElement.HighContrastAdjustment Proprietà

Definizione

Ottiene o imposta un valore che indica se il framework regola automaticamente le proprietà visive dell'elemento quando sono abilitati i temi a contrasto elevato.

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

Valore della proprietà

Valore dell'enumerazione che indica se il framework regola automaticamente le proprietà visive dell'elemento quando sono abilitati i temi a contrasto elevato. Il valore predefinito è Application.

Requisiti Windows

Famiglia di dispositivi
Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)

Commenti

Il valore della proprietà viene ereditato. Se impostato su 'applicazione la regolazione rifletterà ciò che viene impostato per la proprietà HighContrastAdjustment dell'applicazione . Se si imposta la proprietà HighContrastAdjustment di'applicazione su Nessuna verrà disabilitata in modo efficace per tutta l'interfaccia utente nell'applicazione. Può essere abilitato in modo selettivo per un oggetto UIElement impostando in modo esplicito il valore su Auto.
Se impostato su automatico, il framework applica automaticamente le modifiche seguenti agli elementi di testo XAML mentre è abilitato un tema a contrasto elevato:

  • Il colore di primo piano nel testo viene ignorato. Il testo viene colorato utilizzando il colore del testo a contrasto elevato del sistema o il colore disabilitato quando in un controllo padre dove IsEnabled = "False".
  • Il rendering di un rettangolo opaco viene eseguito immediatamente dietro il testo per applicare un rapporto di contrasto elevato.
  • I valori non zero per Opacity vengono ignorati. L'elemento e i relativi elementi figlio verranno visualizzati come se avessero un'opacità pari a 1,0.

Le immagini seguenti illustrano la differenza tra automatica (valore applicazione predefinito) e Nessuna:

Esempio di pulsanti con HighContrastAdjustment impostato su auto.Esempio di pulsanti con HighContrastAdjustment impostato su nessuno.

È possibile impostare HighContrastAdjustment = Nessuno in un OGGETTO UIElement e quindi impostare HighContrastAdjustment = Auto su uno dei relativi discendenti. Tuttavia, il framework non garantisce che il discendente sarà completamente opaco se un'opacità viene applicata a uno dei suoi predecessori.

Si applica a