UIElement.HighContrastAdjustment Propiedad

Definición

Obtiene o establece un valor que indica si el marco ajusta automáticamente las propiedades visuales del elemento cuando se habilitan los temas de contraste alto.

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

Valor de propiedad

Valor de la enumeración que indica si el marco ajusta automáticamente las propiedades visuales del elemento cuando se habilitan los temas de contraste alto. El valor predeterminado es Application.

Requisitos de Windows

Familia de dispositivos
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Comentarios

El valor de la propiedad se hereda. Cuando se establece en Application el ajuste reflejará lo que se establece para la propiedad ApplicationHighContrastAdjustment. Al establecer la propiedad ApplicationHighContrastAdjustment en None se deshabilitará eficazmente para toda la interfaz de usuario de la aplicación. Se puede habilitar selectivamente para un UIElement estableciendo explícitamente el valor en Auto.
Cuando se establece en Auto, el marco aplica automáticamente los siguientes ajustes a los elementos de texto de XAML mientras se habilita un tema de contraste alto:

  • Se omite el color de primer plano del texto. El texto se colorea mediante el color del texto de contraste alto del sistema o el color deshabilitado cuando se encuentra en un Control primario donde IsEnabled = "False".
  • Un rectángulo opaco se representa inmediatamente detrás del texto para aplicar una relación de contraste alto.
  • Se omiten los valores distintos de cero para de opacidad. El elemento y sus elementos secundarios aparecerán como si tuvieran una opacidad de 1,0.

Las imágenes siguientes muestran la diferencia entre automático (el valor predeterminado Application) y None:

Ejemplo de botones con HighContrastAdjustment establecido en auto.Ejemplo de botones con HighContrastAdjustment establecido en none.

Es posible establecer HighContrastAdjustment = None en un UIElement y, a continuación, tener HighContrastAdjustment = Auto en uno de sus descendientes. Sin embargo, el marco no garantiza que el descendiente sea totalmente opaco si se aplica una opacidad en cualquiera de sus antecesores.

Se aplica a