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 Visual konten VisualBrush.

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

• VisualGunakan , yang 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 turunan segera. 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 adalah VisualBrushUIElement atau ContainerVisual. UIElement pada dasarnya mencakup elemen UI apa pun yang dapat berpartisipasi dalam UI untuk aplikasi WPF. ContainerVisual berisi yang DrawingGroup mencakup satu atau beberapa Drawingobjek turunan.

Saat Anda menentukan yang baru Visual untuk VisualBrush dan itu Visual adalah UIElement (seperti panel atau kontrol), sistem tata letak berjalan pada UIElement elemen dan turunannya AutoLayoutContent ketika properti diatur ke true. Namun, akar UIElement 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 VisualBrush visual tidak akan menyebar jika BitmapEffect ada di 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

Tidak VisualBrush dapat dibuat baca-saja (dibekukan) ketika propertinya 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 yang ada Visual .

resourceExpression StaticResource Atau DynamicResource yang mengevaluasi ke instans yang adaVisual. Lihat Sumber Daya XAML.

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	VisualProperty
Properti metadata diatur ke true	Tidak