VisualBrush.Visual Properti

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Mendapatkan atau mengatur konten kuas.

public:
 property System::Windows::Media::Visual ^ Visual { System::Windows::Media::Visual ^ get(); void set(System::Windows::Media::Visual ^ value); };

public System.Windows.Media.Visual Visual { get; set; }

member this.Visual : System.Windows.Media.Visual with get, set

Public Property Visual As Visual

Nilai Properti

Visual

Konten kuas. Defaultnya adalah null.

Keterangan

Ada dua cara untuk menentukan konten Visual dari VisualBrush.

• Buat Visual baru dan gunakan untuk mengatur properti Visual dari VisualBrush.

• Gunakan Visualyang ada , yang membuat gambar duplikat target Visual. Anda kemudian dapat menggunakan VisualBrush untuk membuat efek menarik, seperti refleksi dan pembesaran.

Visual cukup tinggi dalam hierarki kelas WPF secara keseluruhan, sehingga sejumlah besar objek mungkin dapat berfungsi sebagai visual yang Anda gunakan untuk VisualBrush; seluruh daftar tidak dapat ditampilkan di sini. Lihat Visual; lihat bagian "Hierarki Warisan", yang akan menampilkan kelas yang segera diturunkan. Anda kemudian dapat mengklik kelas yang langsung diturunkan dan melintasi hierarki untuk merasakan berbagai kemungkinan. Pada tingkat atas, dua kategori objek paling umum yang mungkin Anda gunakan untuk VisualBrushUIElement atau ContainerVisual. UIElement pada dasarnya mencakup elemen UI apa pun yang dapat berpartisipasi dalam UI untuk aplikasi WPF. ContainerVisual berisi DrawingGroup yang menyertakan satu atau beberapa objek turunan Drawing.

Saat Anda menentukan Visual baru untuk VisualBrush dan bahwa Visual adalah UIElement (seperti panel atau kontrol), sistem tata letak berjalan pada UIElement dan elemen turunannya ketika properti AutoLayoutContent diatur ke true. Namun, UIElement akar pada dasarnya terisolasi dari sisa sistem; gaya, papan cerita, dan tata letak eksternal yang ditentukan oleh induk tempat kuas diterapkan tidak dapat meresap batas ini. Oleh karena itu, Anda harus secara eksplisit menentukan ukuran akar UIElement, karena satu-satunya induknya adalah VisualBrush dan oleh karena itu tidak dapat secara otomatis mengukur dirinya sendiri ke area yang dicat. Untuk informasi selengkapnya tentang tata letak di Windows Presentation Foundation (WPF), lihat tata letak .

Pembaruan pada pohon visual VisualBrush tidak akan menyebar jika BitmapEffect berada dalam rantai induk sikat. Anda dapat mengatasi batasan ini dengan memaksa pembaruan adegan pada objek di atas efek. Anda dapat memanggil InvalidateVisual atau menyertakan animasi untuk memaksa pembaruan adegan.

Nota

VisualBrush tidak dapat dibuat baca-saja (dibekukan) ketika properti Visual diatur ke nilai apa pun selain null.

Penggunaan Elemen Properti XAML

<object>
  <object.Visual>
    singleVisualRoot
  </object.Visual>
</object>

Penggunaan Atribut XAML

< objekVisual="{bindingExpression}"/>

-atau-

< objekVisual="{resourceExpression}"/>

Nilai XAML

singleVisualRoot Elemen objek tunggal yang mendefinisikan elemen visual baru untuk kuas. Ini harus menjadi objek yang berasal dari Visual. Lihat Komentar.

bindingExpression Ekspresi yang mengevaluasi ke instans Visual yang ada.

resourceExpression StaticResource atau DynamicResource yang mengevaluasi ke instans Visual yang ada. LihatSumber Daya XAML .

Informasi Properti Dependensi

Bidang pengidentifikasi	VisualProperty
Properti metadata diatur ke true	Tidak