TileBrush.Viewbox 속성

정의

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)이고, TopLeftWidth가 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 에 맞게 해당 Viewport합니다.The 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
상대 0.0,0.0, Viewbox 인 TileBrush 0.25,0.5TileBrush with a relative Viewbox of 0.0,0.0, 0.25,0.5

다음 그림과 유사한 TileBrush 같지만 상대 Viewbox 으로 0.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 같지만 상대 Viewport 0.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.

Viewbox가 0.5, 0.25 0.25, 0.5 인 TiledTileBrushTiledTileBrush 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, 세 가지 구성 요소를 사용: 콘텐츠, 타일 및 출력 영역입니다.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. 다음 그림에서는 이러한 세 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 보다 작은 해당 Viewport합니다.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.

다른 늘이기 설정이 있는 TileBrushTileBrush with different Stretch settings
여러 Stretch 설정의 TileBrushTileBrush with different Stretch settings

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field ViewboxProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보