次の方法で共有

方法: TileBrush のタイル サイズを設定する

  • [アーティクル]

次の例は、TileBrush のタイル サイズを設定する方法を示しています。 既定では、TileBrush は、描画する領域全体を塗りつぶす 1 つのタイルを生成します。 Viewport プロパティと ViewportUnits プロパティを設定することで、この動作をオーバーライドできます。

Viewport プロパティは、TileBrush のタイル サイズを指定します。 既定では、Viewport プロパティの値は、描画される領域のサイズに対する相対的な値です。 Viewport プロパティで絶対タイル サイズを指定するには、ViewportUnits プロパティを Absolute に設定します。

例

次の例では、TileBrush の一種である ImageBrush を使用して、タイルで四角形を塗りつぶします。 例では、各タイルを出力領域 (四角形) の 50% x 50% に設定します。 その結果、四角形は、イメージの 4 つの投影で塗りつぶされます。

次の図は、この例で生成される出力を示しています。

A rectangle with four cherries demonstrating tiling with an image brush.


//
// Create an ImageBrush and set the size of each
// tile to 50% by 50% of the area being painted.
//
ImageBrush relativeTileSizeImageBrush = new ImageBrush();
relativeTileSizeImageBrush.ImageSource =
    new BitmapImage(new Uri(@"sampleImages\cherries_larger.jpg", UriKind.Relative));
relativeTileSizeImageBrush.TileMode = TileMode.Tile;

// Specify the size of the base tile.
// By default, the size of the Viewport is
// relative to the area being painted,
// so a value of 0.5 indicates 50% of the output
// area.
relativeTileSizeImageBrush.Viewport = new Rect(0, 0, 0.5, 0.5);

// Create a rectangle and paint it with the ImageBrush.
Rectangle relativeTileSizeExampleRectangle = new Rectangle();
relativeTileSizeExampleRectangle.Width = 200;
relativeTileSizeExampleRectangle.Height = 150;
relativeTileSizeExampleRectangle.Stroke = Brushes.LimeGreen;
relativeTileSizeExampleRectangle.StrokeThickness = 1;
relativeTileSizeExampleRectangle.Fill = relativeTileSizeImageBrush;

次の例では、ImageBrush を作成し、その Viewport を 0,0,25,25、ViewportUnits を Absolute に設定して、それを使用して別の四角形を塗りつぶします。 その結果、ブラシでは、幅が 25 ピクセル、高さが 25 ピクセルのタイルが生成されます。

次の図は、この例で生成される出力を示しています。

A rectangle with forty-eight cherries demonstrating a tiled TileBrush with a Viewport.


//
// Create an ImageBrush and set the size of each
// tile to 25 by 25 pixels.
//
ImageBrush absoluteTileSizeImageBrush = new ImageBrush();
absoluteTileSizeImageBrush.ImageSource =
     new BitmapImage(new Uri(@"sampleImages\cherries_larger.jpg", UriKind.Relative));
absoluteTileSizeImageBrush.TileMode = TileMode.Tile;

// Specify that the Viewport is to be interpreted as
// an absolute value.
absoluteTileSizeImageBrush.ViewportUnits = BrushMappingMode.Absolute;

// Set the size of the base tile. Had we left ViewportUnits set
// to RelativeToBoundingBox (the default value),
// each tile would be 25 times the size of the area being
// painted. Because ViewportUnits is set to Absolute,
// the following line creates tiles that are 25 by 25 pixels.
absoluteTileSizeImageBrush.Viewport = new Rect(0, 0, 25, 25);

// Create a rectangle and paint it with the ImageBrush.
Rectangle absoluteTileSizeExampleRectangle = new Rectangle();
absoluteTileSizeExampleRectangle.Width = 200;
absoluteTileSizeExampleRectangle.Height = 150;
absoluteTileSizeExampleRectangle.Stroke = Brushes.LimeGreen;
absoluteTileSizeExampleRectangle.StrokeThickness = 1;
absoluteTileSizeExampleRectangle.Fill = absoluteTileSizeImageBrush;

上記の例は、大規模なサンプルの一部です。 サンプル全体については、「ImageBrush のサンプル」をご覧ください。

この例では ImageBrush クラスを使用していますが、Viewport プロパティと ViewportUnits プロパティは、他の TileBrush オブジェクト (つまり、DrawingBrush と VisualBrush) でも同じように動作します。 ImageBrush および他の TileBrush オブジェクトの詳細については、「イメージ、描画、およびビジュアルによる塗りつぶし」をご覧ください。

関連項目