VisualBrush.Visual Özellik

Tanım

Fırçanın içeriğini alır veya ayarlar.Gets or sets the brush's content.

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.The brush's content. Varsayılan değer: null.The default is null.

Açıklamalar

İçeriğini belirtmek için iki yol vardır Visual VisualBrush .There are two ways to specify the Visual content of a VisualBrush.

  • Yeni bir oluşturun Visual ve özelliğini ayarlamak için kullanın Visual VisualBrush .Create a new Visual and use it to set the Visual property of the VisualBrush.

  • VisualHedefin yinelenen bir görüntüsünü oluşturan var olanı kullanın Visual .Use an existing Visual, which creates a duplicate image of the target Visual. Daha sonra, VisualBrush yansıma ve büyütme gibi ilginç etkileri oluşturmak için kullanabilirsiniz.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visual , genel WPF sınıfı hiyerarşisinde oldukça yüksektir, bu nedenle çok fazla sayıda nesne, için kullandığınız görselde olabilir VisualBrush ; Tüm liste burada gösterilemez.Visual is quite high in the overall WPF class hierarchy, so a very large number of objects could possibly serve as the visual that you use for a VisualBrush; the entire list cannot be shown here. Bkz Visual .; hemen türetilmiş sınıfları gösteren "devralma hiyerarşisi" bölümüne bakın.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Daha sonra, hemen türetilmiş sınıflara tıklayabilir ve tüm olasılıklar yelpazenize ilişkin bir fikir sahibi olmak için hiyerarşileri çapraz gezirsiniz.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. En üst düzeyde, için kullanabileceğiniz en yaygın iki nesne kategorisi VisualBrush veya ' dir UIElement ContainerVisual .At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement , normalde bir WPF uygulaması için Kullanıcı arabirimine katılabilen, temel olarak herhangi bir kullanıcı arabirimi öğesini kapsar.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual bir DrawingGroup veya daha fazla türetilmiş nesne içeren bir içerir Drawing .ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Bir için yeni bir tanımlar Visual (örneğin VisualBrush , bir Visual UIElement panel veya denetim),, özelliği olarak ayarlandığında düzen sistemi UIElement ve onun alt öğeleri üzerinde çalışır AutoLayoutContent true .When you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. Ancak, kök UIElement aslında sistemin geri kalanından ayrılır; stiller, film şeritleri ve fırçanın uygulandığı üst öğe tarafından dikte edilen dış düzen bu sınırı geçemez.However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout dictated by the parent where the brush is applied cannot permeate this boundary. Bu nedenle, UIElement yalnızca üst öğesi olduğu VisualBrush ve bu nedenle kendisini boyanmış alana otomatik olarak boyutlandıramadığı için kök boyutunu açıkça belirtmeniz gerekir.Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. Windows Presentation Foundation (WPF) düzeninde düzen hakkında daha fazla bilgi için bkz. Düzen.For more information about layout in Windows Presentation Foundation (WPF), see the Layout.

' In görsel ağacına yapılan güncelleştirmeler, VisualBrush BitmapEffect fırçanın üst zincirinde bir ise yayılmaz.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. Efektin üzerinde sahne alanının bir güncelleştirmesini zorlayarak bu sınırlamaya geçici çözüm getirebilirsiniz.You can workaround this limitation by forcing an update of the scene on the object above the effect. InvalidateVisualBir sahne güncellemeyle zorlamak için bir animasyon çağırabilir veya ekleyebilirsiniz.You can call InvalidateVisual or include an animation to force a scene update.

Not

VisualBrush Visual Özelliği, özelliği dışında herhangi bir değere ayarlandığında salt okunurdur (dondurulmuş) yapılamaznull.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

XAML Özellik Öğesi KullanımıXAML Property Element Usage

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

XAML Öznitelik KullanımıXAML Attribute Usage

<nesne Visual = "{BindingExpression}"/><object Visual="{bindingExpression}"/>

-veya--or-

<nesne Visual = "{resourceexpression}"/><object Visual="{resourceExpression}"/>

XAML DeğerleriXAML Values

singleVisualRoot
Fırça için yeni görsel öğe tanımlayan tek bir nesne öğesi.A single object element that defines a new visual element for the brush. Bu, öğesinden türetilen bir nesne olmalıdır Visual .This must be an object that derives from Visual. Bkz. açıklamalar.See Remarks.

bindingExpression
Var olan bir örneği değerlendiren bir Visual .A that evaluates to an existing Visual instance.

resourceExpression
Var olan bir StaticResource DynamicResource örneği değerlendiren bir veya Visual .A StaticResource or DynamicResource that evaluates to an existing Visual instance. Bkz. xaml kaynaklarıSee XAML Resources

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanıIdentifier field VisualProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true YokNone

Şunlara uygulanır