Image.NineGrid Propriété

Définition

Espace de noms:

Windows.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 Remarques.

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 préserver les détails sur les coins de l’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 (case 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 qui a le contour dans le cadre d’une image avec transparence. Vous souhaiterez peut-être que la zone centrale contenant une icône s’étire. Mais si vous étirez les coins, vous pouvez obtenir des artefacts d’aliasing à partir des coins arrondis. Ou les côtés de la frontière peuvent devenir trop épais et ne semblent 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 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 XAML pour un élément Image utilisant une valeur NineGrid :

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

Une valeur NineGrid est uniquement pertinente 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 plus grand espace de conteneur et la valeur de Stretch n’est pas** None**).

Voir aussi

• Thickness
• Exemples d’images XAML