RadialGradientBrush Class
Collapse the table of content
Expand the table of content

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.


Namespace:  System.Windows.Media
Assembly:  System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

public sealed class RadialGradientBrush : GradientBrush

XAML Values


One or more GradientStop object elements. Object elements defined here become members of the collection held by the GradientStops property, when accessed by code at runtime.

The RadialGradientBrush type exposes the following members.

Public methodRadialGradientBrush()Initializes a new instance of the RadialGradientBrush class.
Public methodRadialGradientBrush(GradientStopCollection)Initializes a new instance of the RadialGradientBrush class that has the specified gradient stops.
Public methodRadialGradientBrush(Color, Color)Initializes a new instance of the RadialGradientBrush class with the specified start and stop colors.

Public propertyCenterGets or sets the center of the outer circle of the radial gradient.
Public propertyColorInterpolationModeGets or sets a ColorInterpolationMode enumeration value that specifies how the gradient's colors are interpolated. (Inherited from GradientBrush.)
Public propertyDispatcherGets the Dispatcher this object is associated with. (Inherited from DependencyObject.)
Public propertyGradientOriginGets or sets the location of the focal point that defines the beginning of the gradient.
Public propertyGradientStopsGets or sets the brush's gradient stops. (Inherited from GradientBrush.)
Public propertyMappingModeGets 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.)
Public propertyOpacityGets or sets the degree of opacity of a Brush. (Inherited from Brush.)
Public propertyRadiusXGets or sets the horizontal radius of the outer circle of the radial gradient.
Public propertyRadiusYGets or sets the vertical radius of the outer circle of a radial gradient.
Public propertyRelativeTransformGets or sets the transformation that is applied to the brush using relative coordinates. (Inherited from Brush.)
Public propertySpreadMethodGets 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.)
Public propertyTransformGets or sets the transformation that is applied to the brush. (Inherited from Brush.)

Public methodCheckAccessDetermines whether the calling thread has access to this object. (Inherited from DependencyObject.)
Public methodClearValueClears the local value of a dependency property. (Inherited from DependencyObject.)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetAnimationBaseValueReturns any base value established for a Windows Phone dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGetValueReturns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodReadLocalValueReturns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject.)
Public methodSetValueSets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

Public fieldStatic memberCenterPropertyIdentifies the Center dependency property.
Public fieldStatic memberGradientOriginPropertyIdentifies the GradientOrigin dependency property.
Public fieldStatic memberRadiusXPropertyIdentifies the RadiusX dependency property.
Public fieldStatic memberRadiusYPropertyIdentifies 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.

Radial gradient with a highlighted focal point

A radial gradient with highlighted components

In the following example, a radial gradient brush is used to paint the interior of a rectangle.

  <!-- This rectangle is painted with a radial gradient. -->
  <Rectangle Width="200" Height="100">
      <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" />

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.

Gradient stops in a radial gradient

Gradient diagram.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

© 2018 Microsoft