Brush Klasa

Definicja

Definiuje obiekty używane do malowania obiektów graficznych.Defines objects used to paint graphical objects. Klasy, które pochodzą Brush od opisu, w jaki sposób jest malowany obszar.Classes that derive from Brush describe how the area is painted.

public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable
type Brush = class
    inherit Animatable
    interface IFormattable
    interface DUCE.IResource
Public MustInherit Class Brush
Inherits Animatable
Implements IFormattable
Dziedziczenie
Pochodne
Atrybuty
Implementuje

Uwagi

Brush "Maluje" lub "wypełnia" obszar z danymi wyjściowymi.A Brush "paints" or "fills" an area with its output. Różne pędzle mają różne typy danych wyjściowych.Different brushes have different types of output. Niektóre pędzle malują obszar z pełnymi kolorami, innymi z gradientem, wzorcem, obrazem lub rysowaniem.Some brushes paint an area with a solid color, others with a gradient, pattern, image, or drawing. Na poniższej liście opisano różne typy WPFWPF pędzli:The following list describes the different types of WPFWPF brushes:

Wstępnie zdefiniowane pędzlePredefined Brushes

Użyj klasy Brushes , aby malować Obiekt przy użyciu wstępnie zdefiniowanego pełnego koloru, takiego AliceBlue jak Redlub.Use the Brushes class to paint an object using a predefined solid color, such as AliceBlue or Red.

Pędzle w języku XAMLBrushes in XAML

W poniższej tabeli wymieniono różne Brush typy, które mogą być używane XAMLXAML w programie, oraz składnię, które obsługuje.The following table lists the different Brush types that can be used in XAMLXAML and the syntax they support. Aby uzyskać szczegółowe informacje o składni dla określonego pędzla, zobacz stronę typ pędzla.For detailed syntax information for a specific brush, see that brush's type page.

ClassClass Składnia atrybutuAttribute Syntax Składnia elementu obiektuObject Element Syntax
SolidColorBrush TakYes YesYes
DrawingBrush NieNo YesYes
ImageBrush NieNo YesYes
LinearGradientBrush NieNo YesYes
RadialGradientBrush NieNo YesYes
VisualBrush NieNo TakYes

Aby zapoznać się z przykładem pokazującym, jak szybko malować obszar za pomocą pełnego koloru, zobacz How to: Maluj obszar o pełnym kolorze.For an example showing how to quickly paint an area with a solid color, see How to: Paint an Area with a Solid Color.

Funkcje freezableFreezable Features

Pędzel jest typem Freezable obiektu.A brush is a type of Freezable object. Aby uzyskać informacje Freezable o funkcjach, takich jak zamrażanie i klonowanie, zobacz Omówienie obiektów Freezable.For information about Freezable features, such as freezing and cloning, see the Freezable Objects Overview.

Użycie tekstu w języku XAMLXAML Text Usage

Aby XAMLXAML uzyskać więcej informacji, zobacz sekcję uwagi .For XAMLXAML information, see the Remarks section.

Uwagi dotyczące implementowania

W przypadku dziedziczenia z Brush klasy należy CreateInstanceCore() zastąpić metodę.When you inherit from the Brush class, you must override the CreateInstanceCore() method. W zależności od tego, czy Klasa musi wykonać dodatkowe czynności inicjacji lub czy zawiera elementy członkowskie danych niezależności, może być konieczne przesłonięcie dodatkowych Freezable metod.Depending on whether your class must perform additional initialization work or contains non-dependency property data members, you might need to override additional Freezable methods. Aby uzyskać więcej informacji na temat dziedziczenia z Freezable typów, zobacz Omówienie obiektów Freezable.For more information about inheriting from Freezable types, see the Freezable Objects Overview.

Konstruktory

Brush()

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

Pola

OpacityProperty

Identyfikuje właściwość Opacity zależności.Identifies the Opacity dependency property.

RelativeTransformProperty

Identyfikuje właściwość RelativeTransform zależności.Identifies the RelativeTransform dependency property.

TransformProperty

Identyfikuje właściwość Transform zależności.Identifies the Transform dependency property.

Właściwości

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óre zawijają typ CLRCLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Dispatcher Pobiera 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.

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.

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.

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje do określonego DependencyProperty. AnimationClockApplies 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 do określonego DependencyProperty. AnimationClockApplies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior .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, zostanie użyta określona HandoffBehavior .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 DispatcherObjecttego.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 identyfikator DependencyProperty.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 Brushelementu, tworząc głębokie kopie wartości tego obiektu.Creates a modifiable clone of this Brush, making deep copies of this object's values. Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie ma animacji ani ich bieżących wartości.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCore(Freezable)

Sprawia, że wystąpienie jest klonem (głębokiej kopii) określonego Freezable przy użyciu podstawowych (nieanimowanych) wartości właściwości.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 Brush obiektu, tworząc głębokie kopie bieżących wartości tego obiektu.Creates a modifiable clone of this Brush 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 modyfikowalnym klonem (głębokiej kopii) określonego 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. W tym celu należy wywołać dowolną funkcję CoerceValueCallback określoną w metadanych właściwości dla właściwości zależności, która istnieje w DependencyObjectwywoływania.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 klasy pochodnej Freezable.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 właściwość IsFrozen na true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Odziedziczone po Freezable)
FreezeCore(Boolean)

Sprawia, Animatable że ten 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 DependencyPropertyelementu.Returns the non-animated value of the specified DependencyProperty.

(Odziedziczone po Animatable)
GetAsFrozen()

Tworzy zamrożoną kopię Freezableprzy użyciu podstawowych (nieanimowanych) wartości właściwości.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 podstawowych (nieanimowanych) wartości właściwości.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
GetCurrentValueAsFrozen()

Tworzy zamrożoną kopię Freezable przy użyciu 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 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 na tej DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżącego wystąpienia.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 Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnChanged()

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

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zapewnia, że DependencyObjectType dla 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 infrastrukturę Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) 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)

Przesłania DependencyObject implementację OnPropertyChanged(DependencyPropertyChangedEventArgs), aby wywołać także wszystkie procedury obsługi Changed 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 dostęp do Freezable z prawidłowego wątku.Ensures that the Freezable is being accessed from a valid thread. Dziedziczenia Freezable muszą wywoływać 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ę Brushciągu.Return string representation of this 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.

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 zdarzenie Changed dla Freezable i wywołuje jego metodę OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Klasy, które pochodzą z 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 zamrożona i czy jest dostępny z prawidłowego kontekstu wątków.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. dziedziczenia Freezable 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.

Dotyczy

Zobacz też