VisualBrush.Visual Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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é |
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro