Image.NineGrid プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
イメージのサイズを変更する方法を制御する 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 グリッドサイズ変更メタファーの Left、Top、Right、Bottom の測定値を設定する Thickness 値。
注釈
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 の値は、イメージに Width や Height に特定の値が設定されておらず、イメージが拡大されている場合 (イメージはより大きなコンテナー空間にレンダリングされ、 Stretch の値は **なし**) ではない場合にのみ、画像のレンダリングに関連します。