Image.NineGrid Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert für eine Metapher mit neun Rastern ab, die steuert, wie die Größe des Bilds geändert werden kann, oder legt diesen fest. Die Metapher mit neun Rastern ermöglicht es Ihnen, Kanten und Ecken eines Bilds anders als seine Mitte zu strecken. Weitere Informationen und eine Abbildung finden Sie unter Hinweise.

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

Eigenschaftswert

Thickness

Ein Dickenwert, der die Maße "Links", "Oben", "Rechts" und "Unten" für die Metapher zur Größenänderung mit neun Rastern festlegt.

Hinweise

Wenn Sie das Rendering mit neun Rastern verwenden, können Sie angeben, wie verschiedene Bereiche des Bilds gestreckt werden. Dieses Feature ist nützlich, um die Details in Bildecken beizubehalten, wenn ein Bild skaliert oder dehiert wird.

Beim Rendern von neun Rastern wird ein Bild in ein Raster mit neun Abschnitten unterteilt:

Mit dem Rendering von neun Rastern können Sie die ursprünglichen Abmessungen der Ecken (Feldern 1, 3, 7 und 9) beibehalten. Die oberen und unteren (Felder 2 und 8) werden nur horizontal gestreckt, und die Seiten (Felder 4 und 6) werden nur vertikal gestreckt. Die Mitte (Feld 5) wird in beiden Dimensionen gedehnt. Um das Neunrasterrendering zu verwenden, erstellen Sie ein

Das Anwenden von Neunrasterrendering ist sehr nützlich, wenn das Bild selbst eine Art von Rahmen- oder Kantendekoration enthält, die in die Bildquelle eingebettet ist. Stellen Sie sich z. B. vor, Sie verwenden eine Bildquelle für eine Schaltfläche , die die Gliederung als Teil eines Bilds mit Transparenz aufweist. Möglicherweise soll der mittlere Bereich, der ein Symbol enthält, gestreckt werden. Wenn Sie jedoch die Ecken strecken, erhalten Sie möglicherweise Aliasartefakte aus abgerundeten Ecken. Oder die Randseiten werden möglicherweise zu dick und würden nicht so gut aussehen, wenn sie skaliert werden. Um dies zu verhindern, können Sie ein NineGrid mit einheitlichen Werten verwenden, die die Pixelgröße des Rahmens immer die gleiche Größe wie in der Bildquelle beibehalten.

Entweder im Code oder in XAML sind die Werte für die Thickness , die Sie zum Festlegen der NineGrid-Eigenschaft verwenden, geräteunabhängige Pixelwerte.

Hier sehen Sie beispiel xaml für ein Image-Element , das einen NineGrid-Wert verwendet:

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

Ein NineGrid-Wert ist nur für das Rendern von Bildern relevant, wenn für das Bild keine bestimmten Werte für Breite und/oder Höhe festgelegt sind und wo das Bild gestreckt wird (das Bild wird in einen größeren Containerraum gerendert, und der Wert für Stretch ist nicht** None**).

Weitere Informationen

• Thickness
• Beispiel für XAML-Bilder