RadialGradientBrush Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Maluje obszar z gradientem promieniowym. Punkt centralny definiuje początek gradientu, a okrąg definiuje punkt końcowy gradientu.

public ref class RadialGradientBrush sealed : System::Windows::Media::GradientBrush

public sealed class RadialGradientBrush : System.Windows.Media.GradientBrush

type RadialGradientBrush = class
    inherit GradientBrush

Public NotInheritable Class RadialGradientBrush
Inherits GradientBrush

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

GradientBrush

RadialGradientBrush

Uwagi

Wartość jest podobna RadialGradientBrush w modelu programowania do .LinearGradientBrush Jednak gradient liniowy ma początek i punkt końcowy do zdefiniowania wektora gradientu, podczas gdy gradient promieniowy ma okrąg wraz z punktem centralnym w celu zdefiniowania zachowania gradientu. Okrąg definiuje punkt końcowy gradientu. Innymi słowy, gradient zatrzymany o wartości 1,0 definiuje kolor na obwodzie okręgu. Punkt centralny definiuje środek gradientu. Gradient zatrzymany o wartości 0,0 definiuje kolor w punkcie centralnym.

Na poniższej ilustracji przedstawiono prostokąt wypełniony gradientem promieniowym. Gradient promieniowy, który przechodzi od białego do szarego. Okrąg zewnętrzny reprezentuje okrąg gradientu, podczas gdy czerwona kropka oznacza punkt centralny. Ten gradient ma ustawioną SpreadMethod wartość Pad.

Gradient promieniowy z wyróżnionym punktem centralnym

Uwaga

RadialGradientBrush obiekty są renderowane przy użyciu przyspieszania sprzętowego w Tier 2 systemach. Aby uzyskać więcej informacji na temat warstw sprzętowych, zobacz Warstwy renderowania grafiki.

Funkcje zamrażalne

Ponieważ dziedziczy Freezable z klasy, RadialGradientBrush klasa zapewnia kilka specjalnych funkcji: RadialGradientBrush obiekty mogą być deklarowane jako zasoby, współdzielone między wieloma obiektami, wykonane tylko do odczytu, aby zwiększyć wydajność, sklonować i zapewnić bezpieczeństwo wątków. Aby uzyskać więcej informacji o różnych funkcjach udostępnianych przez Freezable obiekty, zobacz Omówienie obiektów z możliwością zamrażania.

Konstruktory

RadialGradientBrush()	Inicjuje nowe wystąpienie klasy RadialGradientBrush.
RadialGradientBrush(Color, Color)	Inicjuje RadialGradientBrush nowe wystąpienie klasy z określonymi kolorami uruchamiania i zatrzymywania.
RadialGradientBrush(GradientStopCollection)	Inicjuje RadialGradientBrush nowe wystąpienie klasy, która ma określone zatrzymanie gradientu.

Pola

CenterProperty	Identyfikuje Center właściwość zależności.
GradientOriginProperty	Identyfikuje GradientOrigin właściwość zależności.
RadiusXProperty	Identyfikuje RadiusX właściwość zależności.
RadiusYProperty	Identyfikuje RadiusY właściwość zależności.

Właściwości

CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
Center	Pobiera lub ustawia środek najbardziej zewnętrznego okręgu gradientu promieniowego.
ColorInterpolationMode	Pobiera lub ustawia wyliczenie ColorInterpolationMode , które określa sposób interpolacji kolorów gradientu. (Odziedziczone po GradientBrush)
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
GradientOrigin	Pobiera lub ustawia lokalizację dwuwymiarowego punktu centralnego, który definiuje początek gradientu.
GradientStops	Pobiera lub ustawia gradient pędzla. (Odziedziczone po GradientBrush)
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)
MappingMode	Pobiera lub ustawia BrushMappingMode wyliczenie określające, czy współrzędne pozycjonowania pędzla gradientowego są bezwzględne, czy względem obszaru wyjściowego. (Odziedziczone po GradientBrush)
Opacity	Pobiera lub ustawia stopień nieprzezroczystości obiektu Brush. (Odziedziczone po Brush)
RadiusX	Pobiera lub ustawia poziomy promień najbardziej zewnętrznego okręgu gradientu promieniowego.
RadiusY	Pobiera lub ustawia pionowy promień najbardziej zewnętrznego okręgu gradientu promieniowego.
RelativeTransform	Pobiera lub ustawia transformację, która jest stosowana do pędzla przy użyciu współrzędnych względnych. (Odziedziczone po Brush)
SpreadMethod	Pobiera lub ustawia typ metody rozprzestrzeniania, która określa sposób narysowania gradientu, który rozpoczyna się lub kończy wewnątrz granic obiektu do malowania. (Odziedziczone po GradientBrush)
Transform	Pobiera lub ustawia transformację, która jest stosowana do pędzla. Ta transformacja jest stosowana po zamapowanym i umieszczonym w danych wyjściowych pędzla. (Odziedziczone po Brush)

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 zostanie użyte 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 DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego RadialGradientBrushobiektu , tworząc głębokie kopie wartości tego obiektu. 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 animacje ani ich bieżące wartości.
CloneCore(Freezable)	Sprawia, że wystąpienie jest klonem (kopią głęboką) określonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable)
CloneCurrentValue()	Tworzy modyfikowalny klon tego RadialGradientBrush 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 modyfikowalny klon (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable)
CoerceValue(DependencyProperty)	Coerce 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 niezmodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że ten Animatable obiekt jest niezmodyfikowalny lub określa, czy można go niemodyfikować. (Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)	Zwraca wartość nie animowaną określonego DependencyPropertyelementu . (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). 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ślonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable)
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)	Sprawia, że bieżące wystąpienie jest klonem zamrożonym określonego Freezableobiektu . Jeśli obiekt ma animowane właściwości zależności, są kopiowane ich bieżące animowane wartości. (Odziedziczone po Freezable)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (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 w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu 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 po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (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ę DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur 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()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable 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 zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego 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ślona 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ść podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwracana reprezentacja ciągu tego Brushelementu . (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 Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu 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 Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, 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)

Zobacz też

• GradientStop
• GradientBrush
• LinearGradientBrush