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í hodnota je null.

Poznámky

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

• Vytvořte novou Visual a použijte ji k nastavení Visual vlastnosti objektu 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 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 bezprostředně 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 objekty VisualBrush nebo UIElementContainerVisual. UIElement zahrnuje v podstatě jakýkoli prvek uživatelského rozhraní, který se může jinak účastnit uživatelského rozhraní pro aplikaci WPF. ContainerVisual DrawingGroup obsahuje jeden nebo více Drawingodvozených objektů.

Při definování nové Visual pro a VisualBrush to Visual je UIElement (například panel nebo ovládací prvek), systém rozložení běží na UIElement podřízených elementech, pokud 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 použit štětec, nemůže tuto hranici permeate. Proto byste měli explicitně zadat velikost kořenového adresáře UIElement, protože jeho jediným nadřazeným objektem VisualBrush je, a proto nemůže automaticky nastavit velikost oblasti, která se maluje. Další informace o rozložení ve Windows Presentation Foundation (WPF) naleznete v rozložení.

Aktualizace vizuálního stromu objektu VisualBrush se nerozšíří, pokud BitmapEffect je v nadřazeném řetězci štětce. 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 vytvořit 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

< ObjektVisual="{bindingExpression}"/>

-nebo-

< ObjektVisual="{resourceExpression}"/>

Hodnoty XAML

singleVisualRoot Jeden objekt element, který definuje nový vizuální prvek pro štětec. To musí být objekt, který je odvozen z 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

Položka	Hodnota
Pole Identifikátor	VisualProperty
Vlastnosti metadat nastavené na true	Žádný