Image.NineGrid Propriété

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" />

Valeur de propriété

Valeur d’épaisseur qui définit les mesures gauche, supérieure, droite et inférieure pour la métaphore de redimensionnement de neuf grilles.

Remarques

Lorsque vous utilisez le rendu de neuf grilles, vous pouvez spécifier la façon dont différentes zones de l’image sont étirées. Cette fonctionnalité est utile pour préserver les détails des angles d’image lorsqu’une image est mise à l’échelle ou s’étire.

Le rendu à neuf grilles divise une image en une grille de neuf sections :

Le rendu à neuf grilles vous permet de conserver les dimensions d’origine des coins (zones 1, 3, 7 et 9). Le haut et le bas (cases 2 et 8) sont étirés horizontalement uniquement, et les côtés (cases 4 et 6) sont étirés verticalement uniquement. Le centre (boîte 5) est étiré dans les deux dimensions. Pour utiliser le rendu à neuf grilles, vous créez un élément Image et spécifiez une valeur pour la propriété NineGrid : valeurs de pixels pour les longueurs des côtés gauche, supérieur, droit et inférieur de la grille. En XAML, vous spécifiez la valeur de l’attribut NineGrid en tant que chaîne qui spécifie les valeurs de pixels pour les côtés en haut, en haut, à droite, dans l’ordre inférieur. En interne, cette syntaxe crée un objet Thickness qui représente ce type de mesure. Si vous souhaitez une valeur uniforme, vous pouvez spécifier une seule valeur appliquée aux quatre bords.

L’application d’un rendu à neuf grilles est très utile lorsque l’image elle-même inclut un type de bordure ou de décoration de bord incorporée dans la source de l’image. Par exemple, imaginez que vous utilisez une source d’image pour un bouton qui a le contour dans le cadre d’une image avec transparence. Vous souhaiterez peut-être que la zone centrale qui contient une icône s’étire. Toutefois, si vous étirez les coins, vous pouvez obtenir des artefacts d’alias à partir d’angles arrondis. Ou les côtés de bordure peuvent être trop épais et ne ressembleraient pas aussi bien quand ils sont mis à l’échelle. Pour éviter cela, vous pouvez utiliser un NineGrid avec des valeurs uniformes qui conservent toujours la taille de pixel de la bordure de la même taille que dans la source d’image.

Dans le code ou en XAML, les valeurs de l’épaisseur que vous utilisez pour définir la propriété NineGrid sont des valeurs de pixel indépendantes de l’appareil.

Voici un exemple XAML pour un élément Image à l’aide d’une valeur NineGrid :

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

Une valeur NineGrid est pertinente uniquement pour le rendu d’image si l’image n’a pas de valeurs spécifiques définies pour Width et/ou Height, et où l’image est étirée (l’image est rendue dans un espace conteneur plus grand et la valeur de Stretch n’est pas** None**).

Voir aussi

• Thickness
• Exemple d’images XAML