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 souboru VisualBrush.

• Create nový Visual a použijte ho VisualVisualBrushk nastavení vlastnosti .

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

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

Když definujete nový Visual objekt a VisualBrush , který Visual je UIElement (například panel nebo ovládací prvek), systém rozložení se spustí na UIElement a jeho 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, nemohou tuto hranici prostupovat. 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 nastavit velikost na malovanou oblast. Další informace o rozložení v Windows Presentation Foundation (WPF) najdete v tématu Rozložení.

Aktualizace do vizuálního VisualBrush stromu se nerozšíří, pokud BitmapEffect je objekt v nadřazené řetězci štětce. Toto omezení můžete obejít vynucením aktualizace scény u objektu nad efektem. Pokud chcete vynutit aktualizaci scény, můžete volat InvalidateVisual nebo zahrnout animaci.

Poznámka

Vlastnost A VisualBrush nelze nastavit jen pro čtení (zamrznout), 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 prvek objektu, který definuje nový vizuální prvek pro štětec. Musí se jednat o objekt, který je odvozen z Visual. Viz Poznámky.

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

resourceExpression Objekt StaticResource nebo DynamicResource , který se vyhodnotí jako existující Visual instance. Viz Prostředky XAML.

Informace o vlastnosti závislosti

Pole Identifikátor	VisualProperty
Vlastnosti metadat nastavené na true	Žádné