VisualBrush Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Maluje obszar za pomocą elementu Visual.

public ref class VisualBrush sealed : System::Windows::Media::TileBrush

public sealed class VisualBrush : System.Windows.Media.TileBrush

type VisualBrush = class
    inherit TileBrush

Public NotInheritable Class VisualBrush
Inherits TileBrush

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

TileBrush

VisualBrush

Uwagi

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

• Twórca nową Visual i 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.

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 nie mogą 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.

Funkcje zamrażalne: Ponieważ dziedziczy Freezable z klasy, VisualBrush klasa zapewnia kilka specjalnych funkcji: VisualBrush obiekty mogą być deklarowane jako i współdzielone między wieloma obiektami. Aby uzyskać więcej informacji na temat różnych funkcji udostępnianych przez Freezable obiekty, zobacz Omówienie obiektów z możliwością zamrażania.

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.

Konstruktory

VisualBrush()	Inicjuje nowe wystąpienie klasy VisualBrush.
VisualBrush(Visual)	Inicjuje VisualBrush nowe wystąpienie klasy zawierającej określony Visualelement .

Pola

AutoLayoutContentProperty	AutoLayoutContent Identyfikuje właściwość zależności.
VisualProperty	Visual Identyfikuje właściwość zależności.

Właściwości

AlignmentX	Pobiera lub ustawia wyrównanie w poziomie zawartości na kafelku TileBrush podstawowym. (Odziedziczone po TileBrush)
AlignmentY	Pobiera lub ustawia wyrównanie w pionie zawartości na kafelku TileBrush podstawowym. (Odziedziczone po TileBrush)
AutoLayoutContent	Pobiera lub ustawia wartość określającą, czy zostanie uruchomiony VisualBrush jej układ Visual.
CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
HasAnimatedProperties	Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable)
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Opacity	Pobiera lub ustawia stopień nieprzezroczystości obiektu Brush. (Odziedziczone po Brush)
RelativeTransform	Pobiera lub ustawia przekształcenie stosowane do pędzla przy użyciu współrzędnych względnych. (Odziedziczone po Brush)
Stretch	Pobiera lub ustawia wartość określającą, w jaki sposób zawartość tego TileBrush rozciągnięcia pasuje do jego kafelków. (Odziedziczone po TileBrush)
TileMode	Pobiera lub ustawia wartość określającą TileBrush sposób wypełniania obszaru, który jest malowany, jeśli kafelek podstawowy jest mniejszy niż obszar wyjściowy. (Odziedziczone po TileBrush)
Transform	Pobiera lub ustawia transformację, która jest stosowana do pędzla. Ta transformacja jest stosowana po zamapowanym i umieszczonym danych wyjściowych pędzla. (Odziedziczone po Brush)
Viewbox	Pobiera lub ustawia położenie i wymiary zawartości na kafelku TileBrush . (Odziedziczone po TileBrush)
ViewboxUnits	Pobiera lub ustawia wartość określającą, czy Viewbox wartość jest względna względem pola TileBrush ograniczenia zawartości, czy też wartość jest bezwzględna. (Odziedziczone po TileBrush)
Viewport	Pobiera lub ustawia położenie i wymiary kafelka podstawowego dla elementu TileBrush. (Odziedziczone po TileBrush)
ViewportUnits	Pobiera lub ustawia BrushMappingMode wyliczenie określające, czy wartość Viewport, która wskazuje rozmiar i położenie kafelka podstawowego TileBrush , jest względem rozmiaru obszaru wyjściowego. (Odziedziczone po TileBrush)
Visual	Pobiera lub ustawia zawartość pędzla.

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable)
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego VisualBrushobiektu , tworząc głębokie kopie wartości tego obiektu.
CloneCore(Freezable)	Sprawia, że wystąpienie jest klonem (kopia głęboka) określonego Freezable obiektu przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable)
CloneCurrentValue()	Tworzy modyfikowalny klon tego VisualBrush obiektu, tworząc głębokie kopie bieżących wartości tego obiektu. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są.
CloneCurrentValueCore(Freezable)	Sprawia, że wystąpienie jest modyfikowalnym klonem (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że ten Animatable obiekt jest niemodyfikowalny lub określa, czy można go zmodyfikować. (Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)	Zwraca nieimętowaną wartość określonego DependencyPropertyelementu . (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię Freezableobiektu przy użyciu podstawowych (nieimowanych) wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Sprawia, że wystąpienie jest zamrożonym klonem określonego Freezable przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable)
GetContentBounds(Rect)	Uzyskuje bieżące granice TileBrush zawartości. (Odziedziczone po TileBrush)
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Powoduje, że bieżące wystąpienie jest zamrożonym klonem określonego Freezableelementu . Jeśli obiekt ma animowane właściwości zależności, zostaną skopiowane bieżące animowane wartości. (Odziedziczone po Freezable)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana, gdy bieżący Freezable obiekt jest modyfikowany. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że dla elementu członkowskiego danych, który właśnie został ustawiony, są ustanawiane DependencyObjectType odpowiednie wskaźniki kontekstu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObject elementu OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Zapewnia dostęp do obiektu Freezable z prawidłowego wątku. Dziedziczenie Freezable elementu musi wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca reprezentację tego Brushciągu . (Odziedziczone po Brush)
ToString(IFormatProvider)	Tworzy reprezentację ciągu tego obiektu na podstawie określonych informacji o formatowaniu specyficznym dla kultury. (Odziedziczone po Brush)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Wywołuje zdarzenie dla klasy Freezable i wywołuje jego OnChanged() metodę. Klasy pochodzące z Freezable klasy powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy element Freezable nie jest zamrożony i czy jest on uzyskiwany z prawidłowego kontekstu wątkowego. Freezable dziedziczenie powinno wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje dane członkom, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)

Jawne implementacje interfejsu

IFormattable.ToString(String, IFormatProvider)

Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu. (Odziedziczone po Brush)