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 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 v celkové hierarchii tříd WPF poměrně vysoký, takže velmi velký počet objektů by mohl sloužit jako vizuál, který používáte pro VisualBrush; Tady nelze zobrazit celý seznam. Viz Visual; viz část 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 VisualBrush, UIElement nebo 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. ContainerVisual obsahuje DrawingGroup, který obsahuje jeden nebo více Drawingodvozených objektů.

Když definujete nový Visual pro VisualBrush a že Visual je UIElement (například panel nebo ovládací prvek), systém rozložení běží na UIElement a jeho podřízených elementech, když je vlastnost AutoLayoutContent nastavena na true. Kořenový UIElement je však v podstatě izolovaný od zbytku systému; styly, scénáře a externí rozložení diktované nadřazeným objektem, ve kterém 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 proto nemůže automaticky nakreslit oblast. Další informace o rozložení ve Windows Presentation Foundation (WPF) naleznete v rozložení.

Aktualizace vizuálního stromu VisualBrush se nerozšíří, pokud je BitmapEffect v nadřazené řetězce š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

Při nastavení vlastnosti Visual na jinou hodnotu než nullnelze VisualBrush nastavit vlastnost jen pro čtení .

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í instance Visual.

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

Informace o vlastnosti závislosti

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