VisualBrush Klasa

Definicja

Maluje obszar z Visual .Paints an area with a 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

Uwagi

Istnieją dwa sposoby określania Visual zawartości VisualBrush .There are two ways to specify the Visual content of a VisualBrush.

  • Utwórz nowy Visual i użyj go do ustawienia Visual właściwości VisualBrush .Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Użyj istniejącego Visual , który tworzy zduplikowany obraz obiektu docelowego Visual .Use an existing Visual, which creates a duplicate image of the target Visual. Następnie można użyć VisualBrush do tworzenia interesujących efektów, takich jak odbicie i powiększanie.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Gdy definiujesz nowy Visual dla a, VisualBrush który Visual jest (na przykład UIElement panel lub kontrolka), system układu jest uruchamiany na UIElement i jego elementach podrzędnych, gdy AutoLayoutContent Właściwość jest ustawiona na true .When you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. Jednak główny UIElement jest głównie odizolowany od reszty systemu. Style, Scenorysy i układ zewnętrzny nie mogą permeate tej granicy.However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout can't permeate this boundary. W związku z tym należy jawnie określić rozmiar elementu głównego UIElement , ponieważ jego jedynym elementem nadrzędnym jest, a w związku z tym VisualBrush nie może on automatycznie zmieniać rozmiaru do rysowanego obszaru.Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. Aby uzyskać więcej informacji na temat układu w Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) , zobacz Układ.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

Aktualizacje drzewa wizualnego obiektu VisualBrush nie zostaną rozpropagowane, jeśli BitmapEffect znajduje się w łańcuchu nadrzędnym pędzla.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. To ograniczenie można obejść, wymuszając aktualizację sceny na obiekcie powyżej danego efektu.You can workaround this limitation by forcing an update of the scene on the object above the effect. InvalidateVisualAby wymusić aktualizację sceny, można wywołać lub dodać animację.You can call InvalidateVisual or include an animation to force a scene update.

Funkcje freezable: Ponieważ dziedziczy z Freezable klasy, VisualBrush Klasa zawiera kilka specjalnych funkcji: VisualBrush obiekty mogą być deklarowane jako i współużytkowane przez wiele obiektów.Freezable Features: Because it inherits from the Freezable class, the VisualBrush class provides several special features: VisualBrush objects can be declared as and shared among multiple objects. Aby uzyskać więcej informacji o różnych funkcjach zapewnianych przez Freezable obiekty, zobacz Omówienie obiektów Freezable.For more information about the different features provided by Freezable objects, see the Freezable Objects Overview.

Uwaga

Element A VisualBrush nie może być tylko do odczytu (zablokowany), gdy jego Visual Właściwość jest ustawiona na dowolną wartość inną niż null.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Konstruktory

VisualBrush()

Inicjuje nowe wystąpienie klasy VisualBrush.Initializes a new instance of the VisualBrush class.

VisualBrush(Visual)

Inicjuje nowe wystąpienie VisualBrush klasy, która zawiera określony element Visual .Initializes a new instance of the VisualBrush class that contains the specified Visual.

Pola

AutoLayoutContentProperty

Identyfikuje AutoLayoutContent Właściwość zależności.Identifies the AutoLayoutContent dependency property.

VisualProperty

Identyfikuje Visual Właściwość zależności.Identifies the Visual dependency property.

Właściwości

AlignmentX

Pobiera lub Ustawia wyrównanie w poziomie zawartości na TileBrush kafelku podstawowym.Gets or sets the horizontal alignment of content in the TileBrush base tile.

(Odziedziczone po TileBrush)
AlignmentY

Pobiera lub Ustawia wyrównanie w pionie zawartości na TileBrush kafelku podstawowym.Gets or sets the vertical alignment of content in the TileBrush base tile.

(Odziedziczone po TileBrush)
AutoLayoutContent

Pobiera lub ustawia wartość określającą, czy VisualBrush ma zostać uruchomiony układ Visual .Gets or sets a value that specifies whether this VisualBrush will run layout its Visual.

CanFreeze

Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny.Gets a value that indicates whether the object can be made unmodifiable.

(Odziedziczone po Freezable)
DependencyObjectType

Pobiera DependencyObjectType , który zawija CLRCLR Typ tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
HasAnimatedProperties

Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z żadną z właściwości zależności tego obiektu.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Odziedziczone po Animatable)
IsFrozen

Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny.Gets a value that indicates whether the object is currently modifiable.

(Odziedziczone po Freezable)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
Opacity

Pobiera lub ustawia stopień nieprzezroczystości Brush .Gets or sets the degree of opacity of a Brush.

(Odziedziczone po Brush)
RelativeTransform

Pobiera lub ustawia transformację stosowaną do pędzla przy użyciu współrzędnych względnych.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Odziedziczone po Brush)
Stretch

Pobiera lub ustawia wartość określającą, jak zawartość tego TileBrush rozciąga się w celu dopasowania do jego kafelków.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

(Odziedziczone po TileBrush)
TileMode

Pobiera lub ustawia wartość określającą, w jaki sposób TileBrush wypełniany jest obszar, gdy podstawowy kafelek jest mniejszy niż obszar wyjściowy.Gets or sets a value that specifies how a TileBrush fills the area that you are painting if the base tile is smaller than the output area.

(Odziedziczone po TileBrush)
Transform

Pobiera lub ustawia transformację stosowaną do pędzla.Gets or sets the transformation that is applied to the brush. To przekształcenie jest stosowane po zmapowaniu i założeniu wyjścia pędzla.This transformation is applied after the brush's output has been mapped and positioned.

(Odziedziczone po Brush)
Viewbox

Pobiera lub ustawia pozycję i wymiary zawartości na TileBrush kafelku.Gets or sets the position and dimensions of the content in a TileBrush tile.

(Odziedziczone po TileBrush)
ViewboxUnits

Pobiera lub ustawia wartość określającą, czy Viewbox wartość jest określana względem pola ograniczenia TileBrush zawartości, czy wartość jest bezwzględna.Gets or sets a value that specifies whether the Viewbox value is relative to the bounding box of the TileBrush contents or whether the value is absolute.

(Odziedziczone po TileBrush)
Viewport

Pobiera lub ustawia pozycję i wymiary kafelka podstawowego dla elementu TileBrush .Gets or sets the position and dimensions of the base tile for a TileBrush.

(Odziedziczone po TileBrush)
ViewportUnits

Pobiera lub ustawia BrushMappingMode Wyliczenie, które określa, czy wartość Viewport , która wskazuje rozmiar i położenie TileBrush kafelka podstawowego, jest względem rozmiaru obszaru wyjściowego.Gets or sets a BrushMappingMode enumeration that specifies whether the value of the Viewport, which indicates the size and position of the TileBrush base tile, is relative to the size of the output area.

(Odziedziczone po TileBrush)
Visual

Pobiera lub ustawia zawartość pędzla.Gets or sets the brush's content.

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje AnimationClock do określonego DependencyProperty .Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie podczas przedania.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje AnimationClock do określonego DependencyProperty .Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, HandoffBehavior zostanie użyta określona.If the property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Stosuje animację do określonego DependencyProperty .Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie podczas przedania.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Stosuje animację do określonego DependencyProperty .Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, HandoffBehavior zostanie użyta określona.If the specified property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
Clone()

Tworzy modyfikowalny klon tego elementu VisualBrush , tworząc głębokie kopie wartości tego obiektu.Creates a modifiable clone of this VisualBrush, making deep copies of this object's values.

CloneCore(Freezable)

Sprawia, że wystąpienie jest klonem (głębokiej kopii) określonej Freezable przy użyciu wartości właściwości Base (Nieanimowane).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
CloneCurrentValue()

Tworzy modyfikowalny klon tego VisualBrush obiektu, tworząc głębokie kopie bieżących wartości tego obiektu.Creates a modifiable clone of this VisualBrush object, making deep copies of this object's current values. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości to.Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

Sprawia, że wystąpienie jest modyfikowalne klonowania (głębokiej kopii) określonej Freezable przy użyciu bieżących wartości właściwości.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Odziedziczone po Freezable)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. 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, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CreateInstance()

Inicjuje nowe wystąpienie klasy Freezable.Initializes a new instance of the Freezable class.

(Odziedziczone po Freezable)
CreateInstanceCore()

Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie Freezable klasy pochodnej.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Odziedziczone po Freezable)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
Freeze()

Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego IsFrozen Właściwość na true .Makes the current object unmodifiable and sets its IsFrozen property to true.

(Odziedziczone po Freezable)
FreezeCore(Boolean)

Sprawia, że ten Animatable obiekt jest niemodyfikowalny lub określa, czy można go nie modyfikować.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)

Zwraca nieanimowaną wartość określonego elementu DependencyProperty .Returns the non-animated value of the specified DependencyProperty.

(Odziedziczone po Animatable)
GetAsFrozen()

Tworzy zamrożoną kopię Freezable , używając wartości właściwości Base (Nieanimowane).Creates a frozen copy of the Freezable, using base (non-animated) property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)

Sprawia, że wystąpienie jest zablokowanym klonem określonego Freezable przy użyciu wartości właściwości Base (Nieanimowane).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
GetContentBounds(Rect)

Uzyskuje bieżące granice TileBrush zawartości.Obtains the current bounds of the TileBrush content.

(Odziedziczone po TileBrush)
GetCurrentValueAsFrozen()

Tworzy zamrożoną kopię z Freezable użyciem bieżących wartości właściwości.Creates a frozen copy of the Freezable using current property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Sprawia, że bieżące wystąpienie jest zablokowanym klonem określonego Freezable .Makes the current instance a frozen clone of the specified Freezable. Jeśli obiekt ma animowane właściwości zależności, ich bieżące wartości animowane są kopiowane.If the object has animated dependency properties, their current animated values are copied.

(Odziedziczone po Freezable)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnChanged()

Wywoływana, gdy bieżący Freezable obiekt jest modyfikowany.Called when the current Freezable object is modified.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zapewnia, że dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony, są ustanowione odpowiednie wskaźniki kontekstu.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ten element członkowski obsługuje Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastrukturę i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Zastępuje DependencyObject implementację programu, OnPropertyChanged(DependencyPropertyChangedEventArgs) Aby wywołać wszystkie Changed procedury obsługi w odpowiedzi na zmianę właściwości zależności typu Freezable .Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
ReadPreamble()

Zapewnia, że Freezable dostęp jest uzyskiwany z prawidłowego wątku.Ensures that the Freezable is being accessed from a valid thread. Dziedziczenia Freezable muszą wywołać tę metodę na początku każdego interfejsu API, który odczytuje składowe danych, które nie są właściwościami zależności.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca reprezentację ciągu Brush .Return string representation of this Brush.

(Odziedziczone po Brush)
ToString(IFormatProvider)

Tworzy ciąg reprezentujący ten obiekt na podstawie określonych informacji o formatowaniu specyficznych dla kultury.Creates a string representation of this object based on the specified culture-specific formatting information.

(Odziedziczone po Brush)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
WritePostscript()

Podnosi Changed zdarzenie dla Freezable i wywołuje jego OnChanged() metodę.Raises the Changed event for the Freezable and invokes its OnChanged() method. Klasy, które pochodzą od Freezable powinny wywołać tę metodę na końcu każdego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Odziedziczone po Freezable)
WritePreamble()

Sprawdza, czy Freezable nie jest zablokowany i czy jest dostępny z prawidłowego kontekstu wątku.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Freezable dziedziczenia powinny wywołać tę metodę na początku każdego interfejsu API, który zapisuje dane w elementach członkowskich, które nie są właściwościami zależności.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable lub obiekt, który zawiera, jest modyfikowany.Occurs when the Freezable or an object it contains is modified.

(Odziedziczone po Freezable)

Jawne implementacje interfejsu

IFormattable.ToString(String, IFormatProvider)

Formatuje wartość bieżącego wystąpienia w określonym formacie.Formats the value of the current instance using the specified format.

(Odziedziczone po Brush)

Dotyczy

Zobacz też