Image.NineGrid Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor para una metáfora de nueve cuadrículas que controla cómo se puede cambiar el tamaño de la imagen. La metáfora de nueve cuadrículas te permite estirar bordes y esquinas de una imagen de forma diferente a su centro. Vea Comentarios para obtener más información y una ilustración.

public:
 property Thickness NineGrid { Thickness get(); void set(Thickness value); };

Thickness NineGrid();

void NineGrid(Thickness value);

public Thickness NineGrid { get; set; }

var thickness = image.nineGrid;
image.nineGrid = thickness;

Public Property NineGrid As Thickness

<Image NineGrid="left,top,right,bottom" />

Valor de propiedad

Thickness

Valor de Grosor que establece las medidas Left, Top, Right, Bottom para la metáfora de cambio de tamaño de nueve cuadrículas.

Comentarios

Al usar la representación de nueve cuadrículas, puede especificar cómo se estiran las distintas áreas de la imagen. Esta característica es útil para conservar los detalles en las esquinas de la imagen cuando una imagen se escala o se estira.

La representación de nueve cuadrículas divide una imagen en una cuadrícula de nueve secciones:

La representación de nueve cuadrículas permite conservar las dimensiones originales de las esquinas (cuadros 1, 3, 7 y 9). La parte superior e inferior (cuadros 2 y 8) solo se estiran horizontalmente, y los lados (cuadros 4 y 6) solo se estiran verticalmente. El centro (cuadro 5) se estira en ambas dimensiones. Para usar la representación de nueve cuadrículas, cree una

La aplicación de la representación de nueve cuadrículas es muy útil cuando la propia imagen incluye algún tipo de borde o decoración perimetral incrustada en el origen de la imagen. Por ejemplo, imagine que usa un origen de imagen para un botón que tiene el contorno como parte de una imagen con transparencia. Es posible que desee el área central que contiene un icono para estirar. Pero si estira las esquinas, es posible que obtenga artefactos de alias de esquinas redondeadas. O bien, los lados del borde podrían ser demasiado gruesos y no se verían tan buenos cuando se escalan. Para evitar esto, podría usar un NineGrid con valores uniformes que siempre mantienen el tamaño de píxel del borde del mismo tamaño que en el origen de la imagen.

En el código o en XAML, los valores del Grosor que usas para establecer la propiedad NineGrid son valores de píxeles independientes del dispositivo.

Este es un ejemplo de XAML para un elemento Image con un valor NineGrid:

<Image Source="Images/9grid.bmp" NineGrid="30,20,30,20" />

Un valor de NineGrid solo es relevante para la representación de imágenes si la imagen no tiene valores específicos establecidos para Width o Height, y donde la imagen se está estirando (la imagen se representa en un espacio contenedor mayor y el valor de Stretch no es** None**).

Consulte también

• Thickness
• Muestra de imágenes XAML