VisualBrush.Visual Özellik

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Fırçanın içeriğini alır veya ayarlar.

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

Özellik Değeri

Visual

Fırçanın içeriği. Varsayılan değer: null.

Açıklamalar

Bir Visual öğesinin içeriğini VisualBrush belirtmenin iki yolu vardır.

• Yeni bir Visual oluşturun ve bunu Visual'nin VisualBrush özelliğini ayarlamak için kullanın.

• Mevcut bir Visual kullanın, bu da hedef Visual öğesinin yinelenen bir görüntüsünü oluşturur. Daha sonra yansıma ve büyütme gibi ilginç efektler oluşturmak için öğesini VisualBrush kullanabilirsiniz.

Visual genel WPF sınıf hiyerarşisinde oldukça yüksek olduğundan, büyük olasılıkla çok fazla sayıda nesne, bir VisualBrushiçin kullandığınız görsel olarak görev yapabilir; listenin tamamı burada gösterilemez. Bkz Visual. ; hemen türetilen sınıfları gösteren "Devralma Hiyerarşisi" bölümüne bakın. Ardından hemen türetilen sınıflara tıklayabilir ve tüm olasılıklar hakkında bir anlayış elde etmek için hiyerarşileri geçirebilirsiniz. En üst düzeyde, bir VisualBrush için kullanabileceğiniz en yaygın iki nesne kategorisi veya UIElementşeklindedirContainerVisual. UIElement temelde bir WPF uygulaması için kullanıcı arabirimine katılabilen tüm ui öğelerini kapsar. ContainerVisualbir veya daha fazla DrawingGrouptüretilmiş nesne içeren bir Drawing içerir.

Yeni bir Visual bir VisualBrush için tanımladığınızda ve o Visual bir UIElement (panel veya kontrol gibi) olduğunda, UIElement özelliği AutoLayoutContent olarak ayarlandığında düzen sistemi true ve onun alt öğeleri üzerinde çalışır. Ancak kök UIElement temelde sistemin geri kalanından yalıtılır; fırçanın uygulandığı üst öğe tarafından dikte edilen stiller, görsel taslaklar ve dış düzen bu sınıra geçirilemez. Bu nedenle, kök UIElementboyutunu açıkça belirtmeniz gerekir, çünkü tek üst öğesidir VisualBrush ve bu nedenle kendisini otomatik olarak boyanacak alana boyutlandıramaz. Windows Presentation Foundation'daki (WPF) düzen hakkında daha fazla bilgi için bkz. Düzen.

Bir, fırçanın üst zincirindeyse, öğesinin VisualBrushBitmapEffect görsel ağacına yapılan güncelleştirmeler yayılmaz. Nesne üzerinde efektin üzerinde bir sahne güncelleştirmesini zorlayarak bu sınırlamaya geçici bir çözüm bulabilirsiniz. Bir sahne güncelleştirmesini zorlamak için animasyon çağırabilir InvalidateVisual veya ekleyebilirsiniz.

Note

VisualBrush özelliği dışında Visualbir değere ayarlandığında , salt okunur (donduruldu) null yapılamaz.

XAML Özellik Öğesi Kullanımı

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

XAML Öznitelik Kullanımı

< NesneVisual="{bindingExpression}"/>

-veya-

< NesneVisual="{resourceExpression}"/>

XAML Değerleri

singleVisualRoot Fırça için yeni bir görsel öğe tanımlayan tek bir nesne öğesi. Bu, öğesinden Visualtüretilen bir nesne olmalıdır. Bkz. Açıklamalar.

bindingExpression Var olan Visual bir örneği değerlendiren bir ifade.

resourceExpression StaticResource Mevcut DynamicResource bir örneği değerlendiren bir veyaVisual. Bkz . XAML Kaynakları.

Bağımlılık Özelliği Bilgileri

Öğe	Değer
Tanımlayıcı alanı	VisualProperty
Meta veri özellikleri olarak ayarlandı true	Hiçbiri