RadialGradientBrush Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Paints an area with a radial gradient. A focal point defines the beginning of the gradient, and a circle defines the end point of the gradient.
System.Windows::DependencyObject
System.Windows.Media::Brush
System.Windows.Media::GradientBrush
System.Windows.Media::RadialGradientBrush
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
The RadialGradientBrush type exposes the following members.
| Name | Description | |
|---|---|---|
 | RadialGradientBrush() | Initializes a new instance of the RadialGradientBrush class. |
| RadialGradientBrush(GradientStopCollection) | Initializes a new instance of the RadialGradientBrush class that has the specified gradient stops. |
| RadialGradientBrush(Color, Color) | Initializes a new instance of the RadialGradientBrush class with the specified start and stop colors. |
| Name | Description | |
|---|---|---|
 | Center | Gets or sets the center of the outer circle of the radial gradient. |
| ColorInterpolationMode | Gets or sets a ColorInterpolationMode enumeration value that specifies how the gradient's colors are interpolated. (Inherited from GradientBrush.) |
| Dispatcher | Gets the Dispatcher this object is associated with. (Inherited from DependencyObject.) |
| GradientOrigin | Gets or sets the location of the focal point that defines the beginning of the gradient. |
| GradientStops | Gets or sets the brush's gradient stops. (Inherited from GradientBrush.) |
| MappingMode | Gets or sets a BrushMappingMode enumeration value that specifies whether the positioning coordinates of the gradient brush are absolute or relative to the output area. (Inherited from GradientBrush.) |
| Opacity | Gets or sets the degree of opacity of a Brush. (Inherited from Brush.) |
| RadiusX | Gets or sets the horizontal radius of the outer circle of the radial gradient. |
| RadiusY | Gets or sets the vertical radius of the outer circle of a radial gradient. |
| RelativeTransform | Gets or sets the transformation that is applied to the brush using relative coordinates. (Inherited from Brush.) |
| SpreadMethod | 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 | Gets or sets the transformation that is applied to the brush. (Inherited from Brush.) |
| Name | Description | |
|---|---|---|
| CheckAccess | Determines whether the calling thread has access to this object. (Inherited from DependencyObject.) |
| ClearValue | Clears the local value of a dependency property. (Inherited from DependencyObject.) |
| Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetAnimationBaseValue | Returns any base value established for a Windows Phone dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetValue | Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ReadLocalValue | Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject.) |
| SetValue | Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
  | CenterProperty | Identifies the Center dependency property. |
| GradientOriginProperty | Identifies the GradientOrigin dependency property. |
| RadiusXProperty | Identifies the RadiusX dependency property. |
| RadiusYProperty | Identifies the RadiusY dependency property. |
The RadialGradientBrush is similar to the LinearGradientBrush. However, the linear gradient has a start and an end point to define the gradient vector, while the radial gradient has a ellipse, along with a focal point (the GradientOrigin), to define the gradient behavior. The ellipse defines the end point of the gradient. In other words, a gradient stop at 1.0 defines the color at the ellipse circumference. The focal point defines the center of the gradient. A gradient stop at 0 defines the color at the focal point.
The following image shows a rectangle filled with a radial gradient. The radial gradient that goes from white to gray. The outside circle represents the gradient ellipse while the red dot denotes the focal point. This gradient has its SpreadMethod set to Pad.
In the following example, a radial gradient brush is used to paint the interior of a rectangle.
<StackPanel> <!-- This rectangle is painted with a radial gradient. --> <Rectangle Width="200" Height="100"> <Rectangle.Fill> <RadialGradientBrush GradientOrigin="0.5,0.5" Center="0.5,0.5" RadiusX="0.5" RadiusY="0.5"> <GradientStop Color="Yellow" Offset="0" /> <GradientStop Color="Red" Offset="0.25" /> <GradientStop Color="Blue" Offset="0.75" /> <GradientStop Color="LimeGreen" Offset="1" /> </RadialGradientBrush> </Rectangle.Fill> </Rectangle> </StackPanel>
The following illustration shows the gradient created in the previous example. The brush's gradient stops have been highlighted. Notice that, even though the results are different, the gradient stops in this example are identical to the gradient stops in the previous linear gradient brush examples.
