Image.NineGrid Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur pour une métaphore à neuf grilles qui contrôle la façon dont l’image peut être redimensionnée. La métaphore à neuf grilles vous permet d’étirer les bords et les coins d’une image différemment de son centre. Pour plus d’informations et une illustration, consultez Notes.

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é

Thickness

Valeur d’épaisseur qui définit les mesures Left, Top, Right, Bottom pour la métaphore de redimensionnement à neuf grilles.

Remarques

Lorsque vous utilisez le rendu à neuf grilles, vous pouvez spécifier la façon dont les différentes zones de l’image sont étirées. Cette fonctionnalité est utile pour conserver les détails sur les coins 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 (cases 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’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 dont le contour fait partie intégrante d’une image avec transparence. Vous souhaiterez peut-être étendre la zone centrale qui contient une icône. Mais si vous étirez les coins, vous pouvez obtenir des artefacts d’alias à partir d’angles arrondis. Ou les côtés de la bordure peuvent devenir trop épais et ne semblent pas aussi bons lorsqu’ils sont mis à l’échelle. Pour éviter cela, vous pouvez utiliser un NineGrid avec des valeurs uniformes qui conservent toujours la taille de pixels 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 DE CODE XAML pour un élément Image utilisant une valeur NineGrid :

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

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

Voir aussi

• Thickness
• Exemples d’images XAML