Export (0) Print
Expand All

RadialGradientBrush.Center Property

Gets or sets the center of the outermost circle of the radial gradient.

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

'Declaration
Public Property Center As Point
<object>
  <object.Center>
    <Point .../>
  </object.Center>
</object>
<object Center="Point" .../>

Property Value

Type: System.Windows.Point
The two-dimensional point located at the center of the radial gradient.

The default central point location of the gradient circle is (0.5, 0.5).

This example shows how to use the RadialGradientBrush class to paint an area with a radial gradient.

The following example uses a RadialGradientBrush to paint a rectangle with a radial gradient that transitions from yellow to red to blue to lime green.



Imports Microsoft.VisualBasic
Imports System
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Input
Imports System.Windows.Media
Imports System.Windows.Media.Animation
Imports System.Windows.Shapes

Namespace BrushesIntroduction
	Public Class RadialGradientBrushSnippet
		Inherits Page
		Public Sub New()
			Title = "RadialGradientBrush Example"
			Background = Brushes.White
			Margin = New Thickness(20)

			'
			' Create a RadialGradientBrush with four gradient stops.
			'
			Dim radialGradient As New RadialGradientBrush()

			' Set the GradientOrigin to the center of the area being painted.
			radialGradient.GradientOrigin = New Point(0.5, 0.5)

			' Set the gradient center to the center of the area being painted.
			radialGradient.Center = New Point(0.5, 0.5)

			' Set the radius of the gradient circle so that it extends to
			' the edges of the area being painted.
			radialGradient.RadiusX = 0.5
			radialGradient.RadiusY = 0.5

			' Create four gradient stops.
			radialGradient.GradientStops.Add(New GradientStop(Colors.Yellow, 0.0))
			radialGradient.GradientStops.Add(New GradientStop(Colors.Red, 0.25))
			radialGradient.GradientStops.Add(New GradientStop(Colors.Blue, 0.75))
			radialGradient.GradientStops.Add(New GradientStop(Colors.LimeGreen, 1.0))

			' Freeze the brush (make it unmodifiable) for performance benefits.
			radialGradient.Freeze()

			' Create a rectangle and paint it with the 
			' RadialGradientBrush.
			Dim aRectangle As New Rectangle()
			aRectangle.Width = 200
			aRectangle.Height = 100
			aRectangle.Fill = radialGradient

			Dim mainPanel As New StackPanel()
			mainPanel.Children.Add(aRectangle)
			Content = mainPanel

		End Sub

	End Class
End Namespace
<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  Title="RadialGradientBrush Example"
  Background="White" Margin="20">
  <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">
          <RadialGradientBrush.GradientStops>
            <GradientStop Color="Yellow" Offset="0" />
            <GradientStop Color="Red" Offset="0.25" />
            <GradientStop Color="Blue" Offset="0.75" />
            <GradientStop Color="LimeGreen" Offset="1" />
          </RadialGradientBrush.GradientStops>
        </RadialGradientBrush>
      </Rectangle.Fill>
    </Rectangle>
  </StackPanel>
</Page>

The following illustration shows the gradient from the preceding example. The gradient's stops have been highlighted.

Gradient stops in a radial gradient
NoteNote

The examples in this topic use the default coordinate system for setting control points. The default coordinate system is relative to a bounding box: 0 indicates 0 percent of the bounding box, and 1 indicates 100 percent of the bounding box. You can change this coordinate system by setting the MappingMode property to the value Absolute. An absolute coordinate system is not relative to a bounding box. Values are interpreted directly in local space.

For additional RadialGradientBrush examples, see the Brushes Sample. For more information about gradients and other types of brushes, see Painting with Solid Colors and Gradients Overview.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft