RadialGradientBrush Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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::GradientBrushpublic sealed class RadialGradientBrush : System.Windows.Media.GradientBrushtype RadialGradientBrush = class
inherit GradientBrushPublic NotInheritable Class RadialGradientBrush
Inherits GradientBrush- Dziedziczenie
-
RadialGradientBrush
Uwagi
Element RadialGradientBrush jest podobny 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, aby zdefiniować zachowanie gradientu. Okrąg definiuje punkt końcowy gradientu. Innymi słowy, stopa gradientu 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, a czerwona kropka oznacza punkt centralny. Ten gradient ma ustawioną wartość SpreadMethodPad.
Gradient promieniowy z wyróżnionym punktem centralnym
Uwaga / Notatka
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 ona z Freezable klasy, RadialGradientBrush klasa zapewnia kilka specjalnych funkcji: RadialGradientBrush obiekty można zadeklarować jako zasoby, współdzielone między wieloma obiektami, wykonane tylko do odczytu w celu zwiększenia wydajności, sklonowania i bezpiecznego wątku. 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.
Konstruktory
| Nazwa | Opis |
|---|---|
| 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
| Nazwa | Opis |
|---|---|
| CenterProperty |
Center Identyfikuje właściwość zależności. |
| GradientOriginProperty |
GradientOrigin Identyfikuje właściwość zależności. |
| RadiusXProperty |
RadiusX Identyfikuje właściwość zależności. |
| RadiusYProperty |
RadiusY Identyfikuje właściwość zależności. |
Właściwości
| Nazwa | Opis |
|---|---|
| CanFreeze |
Pobiera wartość wskazującą, czy obiekt może być niezmodyfikowalny. (Odziedziczone po Freezable) |
| Center |
Pobiera lub ustawia środek najbardziej zewnętrznego okręgu gradientu promieniowego. |
| ColorInterpolationMode |
Pobiera lub ustawia ColorInterpolationMode wyliczenie określające sposób interpolacji kolorów gradientu. (Odziedziczone po GradientBrush) |
| DependencyObjectType |
Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject) |
| Dispatcher |
Pobiera elementDispatcher, z który DispatcherObject jest skojarzony. (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 położenia 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 przekształcenie stosowane 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 danych wyjściowych pędzla. (Odziedziczone po Brush) |
Metody
| Nazwa | Opis |
|---|---|
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
Tworzy wystąpienie klona (kopii głębokiej) określonego Freezable 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 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 niezmodyfikowalny i ustawia jego IsFrozen właściwość na |
| FreezeCore(Boolean) |
Sprawia, że ten Animatable obiekt jest niezmodyfikowalny lub określa, czy można go niemodyfikować. (Odziedziczone po Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Zwraca nie animowaną wartość 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) |
Powoduje, ż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 zamrożonym klonem określonego Freezableelementu . Jeśli obiekt ma animowane właściwości zależności, zostaną skopiowane ich bieżące animowane wartości. (Odziedziczone po Freezable) |
| GetHashCode() |
Pobiera kod skrótu dla tego elementu 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 na tym DependencyObjectobiekcie . (Odziedziczone po DependencyObject) |
| GetType() |
Pobiera Type 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 obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| OnChanged() |
Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie ma być używany bezpośrednio z kodu. (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) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Zastępuje implementację DependencyObject metody OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą 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. Dziedziczy Freezable muszą 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 ź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ść podanej właściwości zależności. (Odziedziczone po DependencyObject) |
| ToString() |
Zwraca reprezentację 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 Wywołuje zdarzenie dla Freezable metody i wywołuje jej 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 Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp z prawidłowego kontekstu wątkowego. Freezable dziedziczy powinny 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
| Nazwa | Opis |
|---|---|
| Changed |
Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable) |
Jawne implementacje interfejsu
| Nazwa | Opis |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu. (Odziedziczone po Brush) |
