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. Default adalah null.

Keterangan

Ada dua cara untuk menentukan Visual konten VisualBrush.

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

• Gunakan yang sudah ada Visual, 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 segera 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 yang Visual merupakan UIElement (seperti panel atau kontrol), sistem tata letak berjalan pada UIElement dan elemen anaknya saat AutoLayoutContent properti diatur ke true. Namun, akar UIElement pada dasarnya diisolasi dari sisa sistem; gaya, papan cerita, dan tata letak eksternal yang ditentukan oleh induk tempat kuas diterapkan tidak dapat meresapi 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.

Updates ke pohon VisualBrush visual tidak akan menyebar jika ada BitmapEffect di rantai induk kuas. Anda dapat mengatasi batasan ini dengan memaksa pembaruan adegan pada objek di atas efeknya. Anda dapat memanggil InvalidateVisual atau menyertakan animasi untuk memaksa pembaruan adegan.

Catatan

VisualBrush tidak 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 Keterangan.

bindingExpression Ekspresi yang mengevaluasi ke instans yang sudah ada Visual .

resourceExpressionStaticResource A atau DynamicResource yang mengevaluasi ke instans yang adaVisual. Lihat Sumber Daya XAML.

Informasi Properti Dependensi

Bidang pengidentifikasi	VisualProperty
Properti metadata diatur ke true	Tidak ada