VisualBrush.Visual Vlastnost

Definice

Získá nebo nastaví obsah štětce.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

Hodnota vlastnosti

Visual

Obsah štětce.The brush's content. Výchozí formát je null.The default is null.

Poznámky

Existují dva způsoby, jak zadat Visual obsah VisualBrush .There are two ways to specify the Visual content of a VisualBrush.

  • Vytvořte nový Visual a použijte ho k nastavení Visual vlastnosti VisualBrush .Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Použijte existující Visual , který vytvoří duplicitní obrázek cíle Visual .Use an existing Visual, which creates a duplicate image of the target Visual. Pak můžete použít VisualBrush k vytvoření zajímavých efektů, jako je například reflexe a zvětšení.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visual je poměrně vysoký v celkové hierarchii tříd WPF, takže velmi velký počet objektů může sloužit jako vizuál, který používáte pro a VisualBrush . celý seznam se tady nedá zobrazit.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. Viz; Přečtěte si Visual část Hierarchie dědičnosti, která zobrazí bezprostředně odvozené třídy.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Pak můžete kliknout na bezprostředně odvozené třídy a procházet hierarchie, abyste získali představu o plném rozsahu možností.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. Na nejvyšší úrovni se jedná o dvě nejběžnější kategorie objektů, které můžete použít pro VisualBrush UIElement nebo ContainerVisual .At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement zahrnuje všechny prvky uživatelského rozhraní, které se mohou jinak účastnit uživatelského rozhraní aplikace WPF.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual obsahuje DrawingGroup , který obsahuje jeden nebo více Drawing objektů odvozených od třídy.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Při definování nového Visual pro VisualBrush a, který Visual je UIElement (například panel nebo ovládací prvek), se systém rozložení spouští v UIElement a jeho podřízené prvky, pokud AutoLayoutContent je vlastnost nastavena na hodnotu 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. Kořen je však v UIElement podstatě izolovaný od zbytku systému. styly, scénáře a externí rozložení, které určuje nadřazený objekt, ve kterém se použití štětce nemůže permeate této hranice.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. Proto byste měli explicitně zadat velikost kořenového adresáře UIElement , protože jeho jediný nadřazený prvek je, VisualBrush a proto nemůže automaticky měnit velikost pro oblast, která je právě vykreslena.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. Další informace o rozložení v nástroji Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) najdete v části rozložení.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

VisualBrushPokud BitmapEffect je v nadřazeném řetězci štětce, aktualizace ve vizuálním stromu nástroje se nerozšíří.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. Toto omezení můžete vyřešit tak, že vynutíte aktualizaci scény na objektu nad efektem.You can workaround this limitation by forcing an update of the scene on the object above the effect. Můžete zavolat InvalidateVisual nebo zahrnout animaci k vynucení aktualizace scény.You can call InvalidateVisual or include an animation to force a scene update.

Poznámka

VisualBrushNedá se nastavit jen pro čtení (zmrazené), když Visual je jeho vlastnost nastavená na jinou hodnotu nežnull.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Použití elementu vlastnosti XAMLXAML Property Element Usage

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

Použití atributu XAMLXAML Attribute Usage

<objekt Visual = "{pokoušel obnovit BindingExpression}"/><object Visual="{bindingExpression}"/>

-nebo--or-

<objekt Visual = "{resourceExpression}"/><object Visual="{resourceExpression}"/>

Hodnoty XAMLXAML Values

singleVisualRoot
Jeden prvek objektu, který definuje nový prvek vizuálu pro štětec.A single object element that defines a new visual element for the brush. Musí se jednat o objekt, který je odvozen z Visual .This must be an object that derives from Visual. Viz poznámky.See Remarks.

bindingExpression
Který je vyhodnocen jako existující Visual instance.A that evaluates to an existing Visual instance.

resourceExpression
A StaticResource DynamicResource , který se vyhodnotí jako existující Visual instance.A StaticResource or DynamicResource that evaluates to an existing Visual instance. Zobrazit prostředky XAMLSee XAML Resources

Informace o vlastnosti závislostiDependency Property Information

Pole identifikátoruIdentifier field VisualProperty
Vlastnosti metadat nastavené na trueMetadata properties set to true ŽádnéNone

Platí pro