GradientFill.FillRect Property

Specifies the gradient fill direction.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v24.1.Core.dll

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

RectangleOffset FillRect { get; set; }

VB.NET

Property FillRect As RectangleOffset

Property Value

Type	Description
RectangleOffset	An object that specifies offsets (in percentage) from the fill rectangle edges to the center shade rectangle.

Remarks

Use the FillRect property to specify a gradient direction. It depends on the gradient type applied to a shape (GradientFill.GradientType). The FillRect property defines the position of the center shade relative to the fill rectangle.

Example 1

In the example below, the center shade occupies the entire shape except for the topmost, leftmost, and rightmost 25% of the rectangle. The gradient fills the remaining area.

C#

// Add a rectangle to the document.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new RectangleF(300, 200, 500, 300));
// Fill the rectangle with a gradient.
rectangle.Fill.SetGradientFill(GradientType.Rectangle, Color.FromArgb(0xF6, 0xCD, 0x61), Color.FromArgb(0xEE, 0x40, 0x35));
// Specify the gradient direction.
rectangle.Fill.GradientFill.FillRect = new RectangleOffset(0.25f, 0.25f, 0.25f, 0f);

VB.NET

' Add a rectangle to the document.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, New RectangleF(300, 200, 500, 300))
' Fill the rectangle with a gradient.
rectangle.Fill.SetGradientFill(GradientType.Rectangle, Color.FromArgb(&HF6, &HCD, &H61), Color.FromArgb(&HEE, &H40, &H35))
' Specify the gradient direction.
rectangle.Fill.GradientFill.FillRect = New RectangleOffset(0.25F, 0.25F, 0.25F, 0F)

Example 2

This example creates a rectangle with a gradient direction that starts from the bottom right corner.

C#

// Add a rectangle to the document.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new RectangleF(300, 200, 500, 300));
// Fill the rectangle with a gradient.
rectangle.Fill.SetGradientFill(GradientType.Rectangle, Color.FromArgb(0xF6, 0xCD, 0x61), Color.FromArgb(0xEE, 0x40, 0x35));
// Specify the following gradient direction: "From Bottom Right Corner".
rectangle.Fill.GradientFill.FillRect = new RectangleOffset(1f, 1f, 0f, 0f);

VB.NET

' Add a rectangle to the document.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, New RectangleF(300, 200, 500, 300))
' Fill the rectangle with a gradient.
rectangle.Fill.SetGradientFill(GradientType.Rectangle, Color.FromArgb(&HF6, &HCD, &H61), Color.FromArgb(&HEE, &H40, &H35))
' Specify the following gradient direction: "From Bottom Right Corner".
rectangle.Fill.GradientFill.FillRect = New RectangleOffset(1F, 1F, 0F, 0F)

Example 3

The example below creates a circle with a radial gradient direction that starts from the center. The FillRect property defines a point in the center of the shape.

C#

// Add a circle to the document.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Oval, new RectangleF(300, 200, 500, 500));
// Apply a three-color gradient to the circle.
GradientStop stop1 = new GradientStop(0f, Color.FromArgb(0xFE, 0xD7, 0x66));
GradientStop stop2 = new GradientStop(0.5f, Color.FromArgb(0xFF, 0x33, 0x77));
GradientStop stop3 = new GradientStop(1f, Color.FromArgb(0x2A, 0x4D, 0x69));
rectangle.Fill.SetGradientFill(GradientType.Circle, new GradientStop[] { stop1, stop2, stop3 });
// Specify the following gradient direction: "From Center".
rectangle.Fill.GradientFill.FillRect = new RectangleOffset(0.5f, 0.5f, 0.5f, 0.5f);

VB.NET

' Add a circle to the document.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Oval, New RectangleF(300, 200, 500, 500))
' Apply a three-color gradient to the circle.
Dim stop1 As New GradientStop(0F, Color.FromArgb(&HFE, &HD7, &H66))
Dim stop2 As New GradientStop(0.5F, Color.FromArgb(&HFF, &H33, &H77))
Dim stop3 As New GradientStop(1F, Color.FromArgb(&H2A, &H4D, &H69))
rectangle.Fill.SetGradientFill(GradientType.Circle, New GradientStop() { stop1, stop2, stop3 })
' Specify the following gradient direction: "From Center".
rectangle.Fill.GradientFill.FillRect = New RectangleOffset(0.5F, 0.5F, 0.5F, 0.5F)