TileBrush.Viewbox プロパティ


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

 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. 既定値は、TopLeft が (0,0)、Width および Height が 1 に設定された四角形 (Rect) です。The default value is a rectangle (Rect) that has a TopLeft of (0,0), and a Width and Height of 1.

@No__t-1 プロパティを使用して TileBrush コンテンツのサイズと位置を指定できます。You can specify the size and position of TileBrush content by using the Viewbox property. @No__t-0 プロパティは、Viewbox の値が、@no__t 2 のコンテンツの境界を基準とした相対値であるか、または絶対値であるかを決定します。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ピクセルのイメージを示しています。その後、このイメージを使用して、@no__t 0 のプロパティ設定が異なる効果を示しています。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 x デバイス非依存ピクセル)Beginning sample image (100 by 100 device independent pixels)

次の図は、0.0、0.0、0.25、0.5 の Viewbox を使用する @no__t 0 の出力を示しています。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. @No__t-0 プロパティは、@no__t がその @no__t をどのように拡大 @no__t するかを決定します。The Stretch property determines how a TileBrush stretches its Viewbox to fill its Viewport.

Viewbox が0、0が0.25、0.5 のタイルブラシTileBrush with a Viewbox of 0,0 0.25,0.5
相対 Viewbox が0.0、0.0、0.25、0.5 のタイルブラシTileBrush with a relative Viewbox of 0.0,0.0, 0.25,0.5

次の図は、@no__t は0ですが、0.5、0.25、0.25、0.5 の相対 @no__t を示しています。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 のタイルブラシTileBrush with a Viewbox of 0.5,0.25 0.25,0.5
同様のタイルブラシですが、Viewbox 設定が異なります。Similar TileBrush but with a different Viewbox setting

次の図は、@no__t 0 ですが、相対 Viewport の値が0.0、0.0、0.5、0.5、@no__t が Tile であることを示しています。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.

Viewbox が0.5、0.25 0.25、0.5 の TiシャードブラシTiledTileBrush with a Viewbox of 0.5,0.25 0.25,0.5
同様のタイルブラシがありますが、タイルと別のビューポートの設定があります。Similar TileBrush but with tiling and a different Viewport setting

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

 Width="100" Height="100">
      Viewbox="0.5,0.25, 0.25,0.5" 
// 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


@No__t-0 を使用して領域を塗りつぶす場合は、コンテンツ、タイル、および出力領域の3つのコンポーネントを使用します。When you paint an area by using a TileBrush, you use three components: content, tiles, and the output area. @No__t-0 プロパティは 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

@No__t-0 プロパティは、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 の内容は、基本タイルの値を設定する @no__t 2 の端にクリップされます。However, TileBrush contents are clipped to the edges of the Viewport, which sets the values for the base tile.

次の図は、ViewboxViewport より小さい @no__t に、異なる @no__t 0 設定がどのように影響するかを示しています。The 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 with different Stretch settings
Stretch 設定が異なる TileBrushTileBrush with different Stretch settings

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

識別子フィールドIdentifier field ViewboxProperty
メタデータプロパティが @no__t に設定される-0Metadata properties set to true なしNone