Image.NineGrid プロパティ

定義

イメージのサイズを変更する方法を制御する 9 グリッドメタファーの値を取得または設定します。 9 グリッドのメタファーを使用すると、画像の端と角を中心とは異なる方法でストレッチできます。 詳細と図については、「解説」を参照してください。

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

プロパティ値

9 グリッドサイズ変更メタファーの LeftTopRightBottom の測定値を設定する Thickness 値。

注釈

9 グリッド レンダリングを使用する場合は、イメージのさまざまな領域を拡大する方法を指定できます。 この機能は、イメージが拡大または縮小されたときに、画像の角の詳細を保持する場合に便利です。

9 グリッド レンダリングでは、イメージが 9 つのセクションのグリッドに分割されます。

9 つのセクションのグリッド。 9 グリッドレンダリングを使用すると、コーナーの元の寸法 (ボックス 1、3、7、9) を保持できます。 上下 (ボックス 2 と 8) は水平方向にのみ引き伸ばされ、側面 (ボックス 4 と 6) は垂直方向にのみ引き伸ばされます。 中央 (ボックス 5) は両方の寸法で引き伸ばされます。 9 グリッド レンダリングを使用するには、

9 グリッド レンダリングを適用すると、イメージ自体に何らかの種類の境界線やエッジ装飾がイメージ ソース内に埋め込まれている場合に非常に便利です。 たとえば、透明度の高い画像の一部としてアウトラインを持つ Button に画像ソースを使用しているとします。 アイコンを含む中心領域を拡大したい場合があります。 ただし、角を広げた場合は、角が丸い部分からエイリアシングアーティファクトを取得する可能性があります。 または、境界線の辺が太くなりすぎて、拡大縮小するとあまりよく見えない場合があります。 これを防ぐために、画像ソースと同じサイズの境界線のピクセル サイズを常に保持する均一な値を持つ NineGrid を使用できます。

コードまたは XAML では、NineGrid プロパティの設定に使用する Thickness の値は、デバイスに依存しないピクセル値です。

NineGrid 値を使用した Image 要素の XAML の例を次に示します。

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

NineGrid の値は、イメージに WidthHeight に特定の値が設定されておらず、イメージが拡大されている場合 (イメージはより大きなコンテナー空間にレンダリングされ、 Stretch の値は **なし**) ではない場合にのみ、画像のレンダリングに関連します。

適用対象

こちらもご覧ください