VisualBrush.Visual Właściwość

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

Wartość właściwości

Zawartość pędzla. Wartość domyślna to null.

Uwagi

Istnieją dwa sposoby określania zawartości Visual elementu VisualBrush.

• Utwórz nową Visual i użyj jej do ustawienia właściwości VisualVisualBrush.

• Użyj istniejącej Visual, która tworzy duplikat obrazu docelowego Visual. Następnie możesz użyć VisualBrush, aby utworzyć interesujące efekty, takie jak odbicie i powiększenie.

Visual jest dość wysoka w ogólnej hierarchii klas WPF, więc bardzo duża liczba obiektów może służyć jako wizualizacja używana dla VisualBrushelementu ; nie można wyświetlić całej listy tutaj. Zobacz Visual; zapoznaj się z sekcją "Hierarchia dziedziczenia", w której będą wyświetlane natychmiast pochodne klasy. Następnie możesz kliknąć natychmiast pochodne klasy i przejść przez hierarchie, aby zrozumieć pełny zakres możliwości. Na najwyższym poziomie dwie najbardziej typowe kategorie obiektów, których można użyć dla obiektu VisualBrush , to UIElement lub ContainerVisual. UIElement obejmuje zasadniczo każdy element interfejsu użytkownika, który w przeciwnym razie może uczestniczyć w interfejsie użytkownika dla aplikacji WPF. ContainerVisual DrawingGroup element zawiera jeden lub więcej Drawingobiektów pochodnych.

Podczas definiowania nowego Visual dla VisualBrush, a Visual jest UIElement (np. panelem lub kontrolką), system układu działa na UIElement i jego elementach podrzędnych, gdy właściwość AutoLayoutContent jest ustawiona na true. Jednak katalog główny UIElement jest zasadniczo odizolowany od reszty systemu; style, scenorysy i układ zewnętrzny dyktowany przez element nadrzędny, w którym stosowana szczotka nie może przeniknąć tej granicy. W związku z tym należy jawnie określić rozmiar korzenia UIElement, ponieważ jego jedynym elementem nadrzędnym jest VisualBrush i dlatego nie może automatycznie dostosowywać swojego rozmiaru do obszaru, który jest malowany. Aby uzyskać więcej informacji na temat układu w programie Windows Presentation Foundation (WPF), zobacz Layout.

Aktualizacje drzewa wizualnego elementu VisualBrush nie będą propagowane, jeśli element BitmapEffect znajduje się w łańcuchu nadrzędnym pędzla. To ograniczenie można obejść, wymuszając aktualizację sceny na obiekcie powyżej efektu. Możesz wywołać InvalidateVisual lub dołączyć animację, aby wymusić aktualizację sceny.

Użytkowanie elementu właściwości XAML

<object>
  <object.Visual>
    singleVisualRoot
  </object.Visual>
</object>

Użycie atrybutu XAML

< ObiektuVisual="{bindingExpression}"/>

— lub —

< ObiektuVisual="{resourceExpression}"/>

Wartości XAML

singleVisualRoot Pojedynczy element obiektu, który definiuje nowy element wizualny dla pędzla. Musi to być obiekt pochodzący z Visualklasy . Zobacz uwagi.

bindingExpression Wyrażenie, które oblicza istniejące Visual wystąpienie.

resourceExpression Obiekt StaticResource lub DynamicResource , który ocenia istniejące Visual wystąpienie. Zobacz Zasoby XAML.

Informacje o właściwości zależności