Image.NineGrid Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts für eine Neun-Raster-Metapher, die steuert, wie die Größe des Bilds geändert werden kann. Mit der Neunrastermetapher können Sie Ränder und Ecken eines Bilds anders als seine Mitte strecken. Weitere Informationen und eine Abbildung finden Sie in den Hinweisen.
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
Ein Stärkewert , der die Größenänderungsmetapher "Left", "Top", "Right", "Bottom ", "Bottom" festlegt.
Hinweise
Wenn Sie neun Rasterrendering verwenden, können Sie angeben, wie verschiedene Bereiche des Bilds gestreckt werden. Dieses Feature ist nützlich, um die Details in Bildecke beizubehalten, wenn ein Bild skaliert oder gestreckt wird.
Das Rendern von neun Rastern unterteilt ein Bild in ein Raster von neun Abschnitten:
Mit neun Rastern können Sie die ursprünglichen Abmessungen der Ecken beibehalten (Felder 1, 3, 7 und 9). 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 (Box 5) wird in beiden Dimensionen gestreckt. Um das Neun-Raster-Rendering zu verwenden, erstellen Sie ein Image-Element und geben einen Wert für die NineGrid-Eigenschaft an– Pixelwerte für die Längen der linken, oberen, rechten und unteren Seiten des Rasters. In XAML geben Sie den NineGrid-Attributwert als Zeichenfolge an, die Pixelwerte für die Seiten in der linken, oberen, rechten, unteren Reihenfolge angibt. Intern erstellt diese Syntax ein Thickness -Objekt, das diese Art von Maß darstellt. Wenn Sie einen einheitlichen Wert wünschen, können Sie nur einen Wert angeben, der auf alle vier Kanten angewendet wird.
Das Anwenden von Neun-Raster-Rendering ist sehr nützlich, wenn das Bild selbst eine Art von Rahmen oder Kantenverzierung enthält, die in der 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 aufweist. Möglicherweise möchten Sie, dass der Mittlere Bereich, der ein Symbol enthält, gestreckt werden soll. Aber wenn Sie die Ecken strecken, erhalten Sie möglicherweise Aliasingartefakte aus abgerundeten Ecken. Oder die Rahmenseiten werden möglicherweise zu dick und würden nicht so gut aussehen, wenn sie skaliert werden. Um dies zu verhindern, könnten Sie ein NineGrid mit uniform-Werten verwenden, die immer die Pixelgröße des Rahmens dieselbe Größe wie in der Bildquelle beibehalten.
Entweder im Code oder in XAML sind die Werte für die Stärke , die Sie zum Festlegen der NineGrid-Eigenschaft verwenden, geräteunabhängige Pixelwerte.
Hier sehen Sie ein Beispiel-XAML für ein Image-Element mit einem NineGrid-Wert:
<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 einem größeren Containerbereich gerendert, und der Wert für Stretch ist nicht** None**).