TileBrush.Viewbox Properti

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Mendapatkan atau mengatur posisi dan dimensi konten dalam TileBrush petak peta.

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

Nilai Properti

Rect

Posisi dan dimensi TileBrush konten. Nilai default adalah persegi panjang (Rect) yang memiliki TopLeft (0,0), dan Width dan Height 1.

Contoh

Anda dapat menentukan ukuran dan posisi TileBrush konten dengan menggunakan Viewbox properti . Properti ViewboxUnits menentukan apakah Viewbox nilai relatif terhadap batas TileBrush konten atau apakah itu adalah nilai absolut.

Ilustrasi pertama menunjukkan gambar 100 kali 100 piksel lalu menggunakan gambar ini untuk menunjukkan efek pengaturan properti yang berbeda Viewbox .

Gambar sampel awal (100 dengan 100 piksel independen perangkat)

Ilustrasi berikut menunjukkan output TileBrush yang menggunakan Viewbox 0,0,0,0, 0,25,0,5. Nilai properti relevan lainnya meliputi yang berikut ini:

• ViewboxUnits: RelativeToBoundingBox (default)

• Viewport: 0,0,1,1

• ViewportUnits: RelativeToBoundingBox

• AlignmentX, : AlignmentYCenter

Ilustrasi ini memperlihatkan beberapa pengaturan properti yang berbeda Stretch . Properti Stretch menentukan bagaimana meregangkan TileBrushViewbox untuk mengisinya Viewport.

Petak PetaBrush dengan Kotak Tampilan relatif 0,0,0,0, 0,25,0,5

Ilustrasi berikutnya menunjukkan hal serupa TileBrush tetapi dengan relatif Viewbox 0,5,0,25, 0,25,0,5.

Petak Peta SerupaBrush tetapi dengan pengaturan Kotak Tampilan yang berbeda

Ilustrasi berikutnya menunjukkan hal yang sama TileBrush tetapi dengan nilai relatif Viewport 0,0,0,0, 0,5,0,5 dan TileMode dari Tile.

TileBrush serupa tetapi dengan ubin dan pengaturan Viewport yang berbeda

Contoh berikut menunjukkan cara membuat petak TileBrush peta yang memiliki Viewbox 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

Keterangan

Saat Anda melukis area dengan menggunakan TileBrush, Anda menggunakan tiga komponen: konten, petak peta, dan area output. Properti Viewbox menentukan ukuran dan posisi TileBrush konten. Ilustrasi berikut menunjukkan bagaimana ketiga TileBrush komponen ini berhubungan satu sama lain.

Komponen TileBrush

Komponen petak peta dari petak peta

Properti ViewboxUnits menentukan apakah nilai ditafsirkan Viewbox sebagai nilai relatif atau absolut. Secara default, ViewboxUnits properti diatur ke RelativeToBoundingBox.

Kliping Kotak Tampilan

TileBrush konten tidak pernah diklip ke Viewbox. Namun, TileBrush konten diklip ke tepi Viewport, yang mengatur nilai untuk petak peta dasar.

Ilustrasi berikut menunjukkan efek pengaturan yang berbeda Stretch pada yang memiliki Viewbox yang lebih kecil dari ViewportTileBrush . Bagian gambar yang berada di luar Viewbox berwarna abu-abu.

Petak PetaBrush dengan pengaturan Stretch yang berbeda

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	ViewboxProperty
Properti metadata diatur ke true	Tidak

Lihat juga

• ViewboxUnits
• Stretch
• Viewport