TileBrush.Viewbox TileBrush.Viewbox TileBrush.Viewbox TileBrush.Viewbox Property

定義

TileBrush タイル内のコンテンツの位置とサイズを取得または設定します。Gets or sets the position and dimensions of the content in a TileBrush tile.

public:
 property System::Windows::Rect Viewbox { System::Windows::Rect get(); void set(System::Windows::Rect value); };
public System.Windows.Rect Viewbox { get; set; }
member this.Viewbox : System.Windows.Rect with get, set
Public Property Viewbox As Rect

プロパティ値

TileBrush コンテンツの位置とサイズ。The position and dimensions of the TileBrush content. 既定値は、Rect が (0,0)、TopLeft および Width が 1 に設定された四角形 (Height) です。The default value is a rectangle (Rect) that has a TopLeft of (0,0), and a Width and Height of 1.

位置とサイズを指定するTileBrushコンテンツを使用して、Viewboxプロパティ。You can specify the size and position of TileBrush content by using the Viewbox property. ViewboxUnitsプロパティを決定するかどうか、Viewboxの境界値は、TileBrushコンテンツかどうか、絶対値で指定します。The ViewboxUnits property determines whether the Viewbox value is relative to the bounds of the TileBrush content or whether it is an absolute value.

最初の図は、100 × 100 ピクセルの画像を表示し、このイメージを使用して、別の効果を表示Viewboxプロパティの設定。The first illustration shows a 100 by 100 pixel image and then uses this image to show the effects of different Viewbox property settings.

イメージAn image
最初のサンプル イメージ (100、100 デバイス非依存ピクセル)Beginning sample image (100 by 100 device independent pixels)

次の図の出力をTileBrushを使用して、 Viewbox 0.0,0.0 の 0.25, 0.5。The following illustration shows the output of a TileBrush that uses a Viewbox of 0.0,0.0, 0.25,0.5. その他の関連するプロパティ値を以下に示します。Other relevant property values include the following:

次に示します。 いくつか異なるStretchプロパティの設定。This illustration shows several different Stretch property settings. Stretchプロパティを決定する方法、TileBrush拡大そのViewbox入力をそのViewportThe Stretch property determines how a TileBrush stretches its Viewbox to fill its Viewport.

Viewbox 0, 0 0.25, 0.5 の TileBrushTileBrush with a Viewbox of 0,0 0.25,0.5
相対 Viewbox 0.0,0.0 の TileBrush 0.25, 0.5TileBrush with a relative Viewbox of 0.0,0.0, 0.25,0.5

次の図を示していますと同様TileBrushが相対的なViewbox0.5,0.25 の 0.25, 0.5 です。The next illustration shows a similar TileBrush but with a relative Viewbox of 0.5,0.25, 0.25,0.5.

Viewbox 0.5,0.25 0.25, 0.5 の TileBrushTileBrush with a Viewbox of 0.5,0.25 0.25,0.5
TileBrush のと同様ですが、別の Viewbox 設定Similar TileBrush but with a different Viewbox setting

次の図に示します同じTileBrushが相対的なViewport0.0,0.0 の値 0.5,0.5 とTileModeTileします。The next illustration shows the same TileBrush but with a relative Viewport value of 0.0,0.0, 0.5,0.5 and a TileMode of Tile.

0.5,0.25 0.25, 0.5 の ViewboxTiledTileBrush with a Viewbox of 0.5,0.25 0.25,0.5
TileBrush のようなタイルと別のビューポートの設定がSimilar TileBrush but with tiling and a different Viewport setting

次の例は、タイルを作成する方法を示しています。TileBrushを持つ、 Viewbox 0.5,0.25、の 0.25, 0.5 です。The following example shows how to create a tiled TileBrush that has a Viewbox of 0.5,0.25, 0.25,0.5.

<Rectangle
 Width="100" Height="100">
  <Rectangle.Fill>
    <ImageBrush 
      ImageSource="sampleImages\testImage.gif"
      Viewbox="0.5,0.25, 0.25,0.5" 
      ViewboxUnits="RelativeToBoundingBox" 
      Viewport="0,0,0.5,0.5"
      ViewportUnits="RelativeToBoundingBox" 
      TileMode="Tile" 
      Stretch="Fill" 
      AlignmentX="Center"
      AlignmentY="Center"/>
  </Rectangle.Fill>
</Rectangle>
// Create a rectangle.
Rectangle myRectangle = new Rectangle();
myRectangle.Width = 100;
myRectangle.Height = 100;

// Load the image.
BitmapImage theImage = 
    new BitmapImage(
        new Uri("sampleImages\\testImage.gif", UriKind.Relative));   
ImageBrush myImageBrush = new ImageBrush(theImage);

myImageBrush.Viewbox = new Rect(0.5, 0.25, 0.25, 0.5);
myImageBrush.ViewboxUnits = BrushMappingMode.RelativeToBoundingBox;
myImageBrush.Viewport = new Rect(0,0,0.25,0.25);
myImageBrush.ViewportUnits = BrushMappingMode.RelativeToBoundingBox;
myImageBrush.TileMode = TileMode.Tile;
myImageBrush.Stretch = Stretch.Fill;
myImageBrush.AlignmentX = AlignmentX.Center;
myImageBrush.AlignmentY = AlignmentY.Center;


// Use the ImageBrush to paint the rectangle's background.
myRectangle.Fill = myImageBrush;
' Create a rectangle.
Dim myRectangle As New Rectangle()
myRectangle.Width = 100
myRectangle.Height = 100

' Load the image.
Dim theImage As New BitmapImage(New Uri("sampleImages\testImage.gif", UriKind.Relative))
Dim myImageBrush As New ImageBrush(theImage)
With myImageBrush
    .Viewbox = New Rect(0.5, 0.25, 0.25, 0.5)
    .ViewboxUnits = BrushMappingMode.RelativeToBoundingBox
    .Viewport = New Rect(0, 0, 0.25, 0.25)
    .ViewportUnits = BrushMappingMode.RelativeToBoundingBox
    .TileMode = TileMode.Tile
    .Stretch = Stretch.Fill
    .AlignmentX = AlignmentX.Center
    .AlignmentY = AlignmentY.Center
End With

' Use the ImageBrush to paint the rectangle's background.
myRectangle.Fill = myImageBrush

注釈

使用して領域を塗りつぶすときに、 TileBrush、3 つのコンポーネントを使用する: コンテンツ、タイル、および出力領域。When you paint an area by using a TileBrush, you use three components: content, tiles, and the output area. Viewboxプロパティは、の位置とサイズを指定します。TileBrushコンテンツ。The Viewbox property specifies the size and position of TileBrush content. 次の図に、これらの 3 つTileBrushコンポーネントが互いに関連します。The following illustration shows how these three TileBrush components relate to each other.

TileBrush コンポーネントTileBrush components
TileBrush コンポーネントTileBrush components

並べて表示された TileBrush のコンポーネントComponents of a tiled TileBrush

ViewboxUnitsプロパティを決定するかどうか、Viewbox値が相対または絶対値として解釈されます。The ViewboxUnits property determines whether the Viewbox value is interpreted as a relative or absolute value. 既定では、ViewboxUnits プロパティは RelativeToBoundingBox に設定されます。By default, the ViewboxUnits property is set to RelativeToBoundingBox.

Viewbox クリッピングViewbox Clipping

TileBrush 内容がクリップされることはありません、Viewboxします。TileBrush contents are never clipped to the Viewbox. ただし、TileBrush内容の境界にクリップ、 Viewport、基本タイルの値を設定します。However, TileBrush contents are clipped to the edges of the Viewport, which sets the values for the base tile.

次の図は、別の効果Stretchの設定、TileBrushを持つ、Viewboxより小さい、 ViewportThe following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. 外部にあるイメージの部分、Viewbox薄い灰色のされます。The parts of the image that are outside the Viewbox are tinted gray.

TileBrush Stretch 設定が異なるTileBrush with different Stretch settings
Stretch 設定が異なる TileBrushTileBrush with different Stretch settings

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field ViewboxProperty
メタデータのプロパティを設定するには trueMetadata properties set to true なしNone

適用対象

こちらもご覧ください