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 obsah pro Visual v rámci VisualBrush.

• Vytvořte nový Visual a použijte ho k nastavení vlastnosti VisualVisualBrush.

• Použijte existující Visual, který vytvoří duplicitní obrázek cílového Visual. Pak můžete pomocí VisualBrush vytvořit zajímavé efekty, jako je odraz a zvětšení.

Visual je poměrně vysoký v celkové hierarchii tříd WPF (Windows Presentation Foundation), 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 (Windows Presentation Foundation). ContainerVisual DrawingGroup obsahuje jeden nebo více Drawingodvozených objektů.

Když definujete nový Visual pro VisualBrush a Visual je UIElement (například panel či ovládací prvek), systém rozvržení běží na UIElement a jeho podřízených elementech, když je vlastnost AutoLayoutContent 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 UIElement, protože jeho jediným nadřazeným objektem je VisualBrush, a tím pádem se nemůže automaticky přizpůsobit malované ploše. Další informace o rozložení ve Windows Presentation Foundation (WPF (Windows Presentation Foundation)) naleznete v části 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.

Note

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

Item	Hodnota
Pole Identifikátor	VisualProperty
Vlastnosti metadat nastavené na true	None