Image.NineGrid Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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. Consulta 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
Valor de grosor que establece las medidas izquierda, superior, derecha e inferior 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 extienden las distintas áreas de la imagen. Esta característica es útil para conservar los detalles en las esquinas de la imagen cuando se escala o se amplía una imagen.
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 extiende en ambas dimensiones. Para usar la representación de nueve cuadrículas, cree un elemento Image y especifique un valor para la propiedad NineGrid: valores de píxeles para las longitudes de los lados izquierdo, superior, derecho e inferior de la cuadrícula. En XAML, se especifica el valor del atributo NineGrid como una cadena que especifica valores de píxeles para los lados en orden izquierdo, superior, derecho e inferior. Internamente, esta sintaxis crea un objeto Thickness que representa este tipo de medida. Si desea un valor uniforme, puede especificar solo un valor que se aplique a los cuatro bordes.
Aplicar 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 dentro del 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 que el área central que contiene un icono se ajuste. Pero si extiende 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 escalaban. Para evitarlo, podría usar nineGrid con valores uniformes que mantengan siempre 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 mediante un valor NineGrid:
<Image Source="Images/9grid.bmp" NineGrid="30,20,30,20" />
Un valor nineGrid solo es relevante para la representación de imágenes si la imagen no tiene valores específicos establecidos para Width y/o Height, y donde la imagen se está estirando (la imagen se representa en un espacio de contenedor más grande y el valor de Stretch no es** None**).