RadialGradientBrush Class

Definition

Pinta un área con un degradado radial.Paints an area with a radial gradient. Un punto focal define el principio del degradado y un círculo define el punto final.A focal point defines the beginning of the gradient, and a circle defines the end point of the gradient.

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
Inheritance

Remarks

El RadialGradientBrush es similar en el modelo de programación al LinearGradientBrush.The RadialGradientBrush is similar in programming model to the LinearGradientBrush. Sin embargo, el degradado lineal tiene un punto de inicio y un extremo para definir el vector de degradado, mientras que el degradado radial tiene un círculo, junto con un punto focal, para definir el comportamiento del degradado.However, the linear gradient has a start and an end point to define the gradient vector, while the radial gradient has a circle, along with a focal point, to define the gradient behavior. El círculo define el punto final del degradado.The circle defines the end point of the gradient. En otras palabras, un delimitador de degradado en 1,0 define el color de la circunferencia del círculo.In other words, a gradient stop at 1.0 defines the color at the circle's circumference. El punto focal define el centro del degradado.The focal point defines the center of the gradient. Un delimitador de degradado en 0,0 define el color en el punto focal.A gradient stop at 0.0 defines the color at the focal point.

La siguiente imagen muestra un rectángulo relleno con un degradado radial.The following image shows a rectangle filled with a radial gradient. Degradado radial que va de blanco a gris.The radial gradient that goes from white to gray. El círculo exterior representa el círculo de degradado mientras que el punto rojo denota el punto focal.The outside circle represents the gradient circle while the red dot denotes the focal point. Este degradado tiene su SpreadMethod establecido en Pad.This gradient has its SpreadMethod set to Pad.

Degradado radial con componentes resaltadosA radial gradient with highlighted components
Degradado radial con un punto focal resaltadoRadial gradient with a highlighted focal point

Note

RadialGradientBrush objetos se representan mediante la aceleración de hardware en Tier 2 sistemas.RadialGradientBrush objects are rendered using hardware acceleration on Tier 2 systems. Para obtener más información sobre los niveles de hardware, vea niveles de representación de gráficos.For more information about hardware tiers, see Graphics Rendering Tiers.

Características de los objetos FreezableFreezable Features

Dado que hereda de la clase Freezable, la clase RadialGradientBrush proporciona varias características especiales: los objetos RadialGradientBrush se pueden declarar como, compartir entre varios objetos, convertirse en de solo lectura para mejorar el rendimiento, clonarse y hacer que los subprocesos sean seguros.Because it inherits from the Freezable class, the RadialGradientBrush class provides several special features: RadialGradientBrush objects can be declared as , shared among multiple objects, made read-only to improve performance, cloned, and made thread safe. Para obtener más información sobre las distintas características proporcionadas por Freezable objetos, vea información general sobre objetos Freezable.For more information about the different features provided by Freezable objects, see Freezable Objects Overview.

Constructors

RadialGradientBrush()

Inicializa una nueva instancia de la clase RadialGradientBrush.Initializes a new instance of the RadialGradientBrush class.

RadialGradientBrush(Color, Color)

Inicializa una nueva instancia de la clase RadialGradientBrush con los colores de inicio y fin especificados.Initializes a new instance of the RadialGradientBrush class with the specified start and stop colors.

RadialGradientBrush(GradientStopCollection)

Inicializa una nueva instancia de la clase RadialGradientBrush con los puntos de degradado especificados.Initializes a new instance of the RadialGradientBrush class that has the specified gradient stops.

Fields

CenterProperty

Identifica la propiedad de dependencia Center.Identifies the Center dependency property.

GradientOriginProperty

Identifica la propiedad de dependencia GradientOrigin.Identifies the GradientOrigin dependency property.

RadiusXProperty

Identifica la propiedad de dependencia RadiusX.Identifies the RadiusX dependency property.

RadiusYProperty

Identifica la propiedad de dependencia RadiusY.Identifies the RadiusY dependency property.

Properties

CanFreeze

Obtiene un valor que indica si el objeto se puede convertir en no modificable.Gets a value that indicates whether the object can be made unmodifiable.

(Inherited from Freezable)
Center

Obtiene o establece el centro del círculo exterior del degradado radial.Gets or sets the center of the outermost circle of the radial gradient.

ColorInterpolationMode

Obtiene o establece una enumeración ColorInterpolationMode que especifica cómo se interpolan los colores del degradado.Gets or sets a ColorInterpolationMode enumeration that specifies how the gradient's colors are interpolated.

(Inherited from GradientBrush)
DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
GradientOrigin

Obtiene o establece la ubicación del punto focal bidimensional que define el inicio del degradado.Gets or sets the location of the two-dimensional focal point that defines the beginning of the gradient.

GradientStops

Obtiene o establece los delimitadores de degradado del pincel.Gets or sets the brush's gradient stops.

(Inherited from GradientBrush)
HasAnimatedProperties

Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Inherited from Animatable)
IsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.Gets a value that indicates whether the object is currently modifiable.

(Inherited from Freezable)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
MappingMode

Obtiene o establece una enumeración BrushMappingMode que especifica si las coordenadas de posicionamiento del pincel de degradado son absolutas o relativas con respecto al área de salida.Gets or sets a BrushMappingMode enumeration that specifies whether the gradient brush's positioning coordinates are absolute or relative to the output area.

(Inherited from GradientBrush)
Opacity

Obtiene o establece el grado de opacidad de Brush.Gets or sets the degree of opacity of a Brush.

(Inherited from Brush)
RadiusX

Obtiene o establece el radio horizontal del círculo exterior del degradado radial.Gets or sets the horizontal radius of the outermost circle of the radial gradient.

RadiusY

Obtiene o establece el radio vertical del círculo exterior de un degradado radial.Gets or sets the vertical radius of the outermost circle of a radial gradient.

RelativeTransform

Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Inherited from Brush)
SpreadMethod

Obtiene o establece el tipo de método de propagación que especifica cómo dibujar un degradado que comienza o finaliza dentro de los límites del objeto que se pinta.Gets or sets the type of spread method that specifies how to draw a gradient that starts or ends inside the bounds of the object to be painted.

(Inherited from GradientBrush)
Transform

Obtiene o establece la transformación que se aplica al pincel.Gets or sets the transformation that is applied to the brush. Esta transformación se aplica después de haber asignado y colocado la salida del pincel.This transformation is applied after the brush's output has been mapped and positioned.

(Inherited from Brush)

Methods

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Inherited from Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

(Inherited from Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Inherited from Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado.If the specified property is already animated, the specified HandoffBehavior is used.

(Inherited from Animatable)
CheckAccess()

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
Clone()

Crea un clon modificable de RadialGradientBrushy hace copias en profundidad de los valores de este objeto.Creates a modifiable clone of this RadialGradientBrush, making deep copies of this object's values. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.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)

Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
CloneCurrentValue()

Crea un clon modificable de este objeto RadialGradientBrush y hace copias en profundidad de sus valores actuales.Creates a modifiable clone of this RadialGradientBrush object, making deep copies of this object's current values. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Inherited from Freezable)
CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstance()

Inicializa una nueva instancia de la clase Freezable.Initializes a new instance of the Freezable class.

(Inherited from Freezable)
CreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Inherited from Freezable)
Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
Freeze()

Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Inherited from Freezable)
FreezeCore(Boolean)

Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Inherited from Animatable)
GetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado del objeto DependencyProperty especificado.Returns the non-animated value of the specified DependencyProperty.

(Inherited from Animatable)
GetAsFrozen()

Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetAsFrozenCore(Freezable)

Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de propiedades base (no animadas).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
GetCurrentValueAsFrozen()

Crea una copia inmovilizada de Freezable con los valores de propiedad actuales.Creates a frozen copy of the Freezable using current property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convierte la instancia actual en un clon inmovilizado del valor de Freezable especificado.Makes the current instance a frozen clone of the specified Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.If the object has animated dependency properties, their current animated values are copied.

(Inherited from Freezable)
GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property.

(Inherited from DependencyObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnChanged()

Se le llama cuando el objeto Freezable actual se modifica.Called when the current Freezable object is modified.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Inherited from Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Inherited from Freezable)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReadPreamble()

Se asegura de que se tiene acceso a Freezable desde un subproceso válido.Ensures that the Freezable is being accessed from a valid thread. Los herederos de Freezable deben llamar a este método al inicio de las API que leen miembros de datos que no son propiedades de dependencia.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Inherited from Freezable)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia suministrada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString()

Devuelve una representación en forma de cadena de Brush.Return string representation of this Brush.

(Inherited from Brush)
ToString(IFormatProvider)

Crea una representación de cadena de este objeto con la información de formato específica de la referencia cultural especificada.Creates a string representation of this object based on the specified culture-specific formatting information.

(Inherited from Brush)
VerifyAccess()

Exige que el subproceso de la llamada tenga acceso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
WritePostscript()

Genera el evento Changed para Freezable e invoca su método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia.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.

(Inherited from Freezable)
WritePreamble()

Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Los herederos de Freezable deben llamar a este método al inicio de las API que escriben en miembros de datos que no son propiedades de dependencia.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Inherited from Freezable)

Events

Changed

Se produce cuando se modifican la clase Freezable o un objeto que la contiene.Occurs when the Freezable or an object it contains is modified.

(Inherited from Freezable)

Explicit Interface Implementations

IFormattable.ToString(String, IFormatProvider)

Da formato al valor de la instancia actual con el formato especificado.Formats the value of the current instance using the specified format.

(Inherited from Brush)

Applies to

See also