VisualBrush.Visual Vlastnost

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Získá nebo nastaví obsah štětce.

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. Výchozí formát je null.

Poznámky

Existují dva způsoby, jak určit Visual obsah VisualBrushsouboru .

• Vytvořte novou Visual a použijte ji k nastavení Visual vlastnosti VisualBrush.

• Použijte existující Visual, který vytvoří duplicitní obrázek cíle Visual. Pak můžete použít VisualBrush k vytvoření zajímavých efektů, jako je odraz a zvětšení.

Visual je poměrně vysoký v celkové hierarchii tříd WPF, takže velmi velký počet objektů může pravděpodobně sloužit jako vizuál, který používáte pro ; VisualBrushcelý seznam zde nelze zobrazit. Viz část Visual"Hierarchie dědičnosti", která zobrazí okamžitě odvozené třídy. Potom můžete kliknout na okamžitě odvozené třídy a procházet hierarchie, abyste získali představu o celé řadě možností. Na nejvyšší úrovni jsou dvě nejběžnější kategorie objektů, které můžete použít pro VisualBrush objekty nebo UIElement ContainerVisual. UIElement zahrnuje v podstatě jakýkoli prvek uživatelského rozhraní, který se může jinak účastnit uživatelského rozhraní pro aplikaci WPF. ContainerVisualDrawingGroup obsahuje jeden nebo více Drawingodvozených objektů.

Když definujete novou Visual pro VisualBrush a to Visual je UIElement (například panel nebo ovládací prvek), systém rozložení se spustí na UIElement podřízených elementech, když AutoLayoutContent je vlastnost nastavena na true. Kořen UIElement je však v podstatě izolovaný od zbytku systému; styly, scénáře a externí rozložení diktované nadřazeným objektem, kde je štětec použit, nemůže tuto hranici permeate. Proto byste měli explicitně zadat velikost kořene UIElement, protože jeho jediným nadřazeným objektem je, VisualBrush a proto nemůže automaticky velikost sama o sobě na plochu, která je malována. Další informace o rozložení v Windows Presentation Foundation (WPF) najdete v tématu Rozložení.

Pokud je nadřazený řetězec štětce, aktualizace vizuálního VisualBrush stromu se nerozšíří BitmapEffect . Toto omezení můžete obejít vynucením aktualizace scény na objektu nad efektem. Můžete volat InvalidateVisual nebo zahrnout animaci, která vynutí aktualizaci scény.

Poznámka

Nelze VisualBrush provést jen pro čtení (zmrazené), pokud je jeho Visual vlastnost nastavena na jinou hodnotu než null.

Použití elementu vlastnosti XAML

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

Použití atributu XAML

<Objekt Visual ="{bindingExpression}"/>

-nebo-

<Objekt Visual ="{resourceExpression}"/>

Hodnoty XAML

singleVisualRoot
Jeden prvek objektu, který definuje nový vizuální prvek pro štětec. Toto musí být objekt, který je odvozen od Visual. Viz Poznámky.

bindingExpression
Výraz, který se vyhodnotí jako existující Visual instance.

resourceExpression
A StaticResource nebo DynamicResource která se vyhodnotí jako existující Visual instance. Viz prostředky XAML.

Informace o vlastnosti závislosti

Pole identifikátoru	VisualProperty
Vlastnosti metadat nastavené na true	Žádné