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 elementu VisualBrush.

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

• Użyj istniejącego Visualobiektu , który tworzy zduplikowany obraz obiektu docelowego Visual. Następnie możesz użyć polecenia 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 elementu VisualBrush; nie można wyświetlić całej listy tutaj. Zobacz Visual; zapoznaj się z sekcją "Hierarchia dziedziczenia", która pokaże natychmiast pochodne klasy. Następnie możesz kliknąć natychmiast pochodne klasy i przejść przez hierarchie, aby uzyskać poczucie pełnego zakresu możliwości. Na najwyższym poziomie dwie najbardziej typowe kategorie obiektów, których można użyć dla elementu 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. ContainerVisualDrawingGroup zawiera jeden lub więcej Drawingobiektów pochodnych.

Podczas definiowania nowego Visual elementu i jest UIElementVisual to (na przykład panel lub kontrolka), system układu jest uruchamiany na UIElement elementach podrzędnych i, gdy AutoLayoutContent właściwość jest ustawiona na trueVisualBrush . Jednak katalog główny UIElement jest zasadniczo odizolowany od reszty systemu; style, scenorysy i układ zewnętrzny dyktowany przez obiekt 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 rozmiarować się do malowanego obszaru. Aby uzyskać więcej informacji na temat układu w Windows Presentation Foundation (WPF), zobacz Układ.

Aktualizacje do drzewa wizualnego elementu VisualBrush nie będzie 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.

Uwaga

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

Użycie elementu właściwości języka XAML

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

Użycie atrybutu języka XAML

<ObiektuVisual ="{bindingExpression}"/>

-lub-

<ObiektuVisual ="{resourceExpression}"/>

Wartości XAML

singleVisualRoot
Pojedynczy element obiektu, który definiuje nowy element wizualny pędzla. Musi to być obiekt, który pochodzi z Visual. Zobacz uwagi.

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

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

Informacje dotyczące właściwości zależności

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