Image.NineGrid Eigenschaft

Definition

Namespace:

Windows.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 gestreckt wird.

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

Mit dem Neunrasterrendering können Sie die ursprünglichen Abmessungen der Ecken (Felder 1, 3, 7 und 9) beibehalten. Die obere und die untere Seite (Felder 2 und 8) sind nur horizontal gestreckt, und die Seiten (Kästen 4 und 6) werden nur vertikal gestreckt. Die Mitte (Kasten 5) wird in beiden Dimensionen gestreckt. Um das Neun-Raster-Rendering zu verwenden, erstellen Sie eine

Das Anwenden des Renderings mit neun Rastern ist sehr nützlich, wenn das Bild selbst einen Rahmen oder eine Kantendekoration enthält, die in die Bildquelle eingebettet ist. Stellen Sie sich beispielsweise vor, Sie verwenden eine Bildquelle für eine Schaltfläche , die die Gliederung als Teil eines Bilds mit Transparenz enthält. Möglicherweise soll der mittlere Bereich, der ein Symbol enthält, gestreckt werden. Wenn Sie jedoch die Ecken strecken, erhalten Sie möglicherweise Aliasingartefakte aus abgerundeten Ecken. Oder die Rahmenseiten könnten zu dick werden und nicht so gut aussehen, wenn sie skaliert werden. Um dies zu verhindern, können Sie ein NineGrid mit einheitlichen Werten verwenden, bei denen die Pixelgröße des Rahmens immer dieselbe Größe wie in der Bildquelle beibehalten wird.

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

Im folgenden 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 Containerbereich gerendert, und der Wert für Stretch ist nicht** None**).

Weitere Informationen

• Thickness
• Beispiel für XAML-Bilder