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 Visual zawartości obiektu VisualBrush.

• Utwórz nowy Visual element i użyj go, aby ustawić Visual właściwość VisualBrush.

• Użyj istniejącego Visualobiektu , który tworzy zduplikowany obraz obiektu docelowego Visual. Następnie możesz użyć elementu 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 elementu VisualBrush i Visual jest to UIElement (np. panel lub kontrolka), system układu jest uruchamiany na elementach UIElement podrzędnych i, gdy AutoLayoutContent właściwość jest ustawiona na truewartość . 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 katalogu głównego UIElement, ponieważ jego jedynym elementem nadrzędnym jest VisualBrush i dlatego nie może automatycznie dodawać rozmiaru do malowanego obszaru. Aby uzyskać więcej informacji na temat układu w programie Windows Presentation Foundation (WPF), zobacz Układ.

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.

Nuta

Nie VisualBrush można dokonać tylko do odczytu (zamrożone), gdy jego Visual właściwość 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

< 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

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