VisualBrush.Visual Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Pobiera lub ustawia zawartość pędzla.

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

Visual

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

Uwagi

Istnieją dwa sposoby określania zawartości VisualVisualBrush.

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

• Użyj istniejącej Visual, która tworzy zduplikowany obraz Visualdocelowego . 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 do VisualBrush; nie można wyświetlić całej listy w tym miejscu. 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 VisualBrush, to UIElement lub ContainerVisual. UIElement obejmuje zasadniczo dowolny element interfejsu użytkownika, który w przeciwnym razie może uczestniczyć w interfejsie użytkownika dla aplikacji WPF. ContainerVisual zawiera DrawingGroup, który zawiera co najmniej jeden obiekt pochodny Drawing.

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

Aktualizacje drzewa wizualnego VisualBrush nie będą propagowane, jeśli 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.

Nuta

Nie można ustawić VisualBrush tylko do odczytu (zamrożone), gdy jej właściwość Visual jest ustawiona na dowolną wartość inną niż null.

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

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

Użycie atrybutu XAML

< objectVisual="{bindingExpression}"/>

-lub-

< objectVisual="{resourceExpression}"/>

Wartości XAML

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

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

resourceExpression StaticResource lub DynamicResource, która ocenia istniejące wystąpienie Visual. Zobacz zasoby XAML.

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

Pole identyfikatora	VisualProperty
Właściwości metadanych ustawione na true	Żaden