ShapeFill.PictureFill Property

Provides access to picture fill settings.

Namespace: DevExpress.XtraRichEdit.API.Native

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

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

Declaration

C#

PictureFill PictureFill { get; }

VB.NET

ReadOnly Property PictureFill As PictureFill

Property Value

Type	Description
PictureFill	An object that stores picture fill settings.

Remarks

Picture Fill

Call the Shape.Fill.SetPictureFill method to fill a shape with a picture. Use the Shape.Fill.PictureFill.FillRect property to specify which part of the shape the picture should occupy.

The example below shows how to fill the entire rectangle with a picture except for the top and bottom 10%.

C#

// Create a rectangle.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new RectangleF(300, 200, 480, 400));
// Use a picture to fill the rectangle.
rectangle.Fill.SetPictureFill(DocumentImageSource.FromFile("PictureFill_Dog.png"));
// Specify which part of the rectangle the picture should occupy.
rectangle.Fill.PictureFill.FillRect = new RectangleOffset(0f, 0.1f, 0f, 0.1f);

VB.NET

' Create a rectangle.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, New RectangleF(300, 200, 480, 400))
' Use a picture to fill the rectangle.
rectangle.Fill.SetPictureFill(DocumentImageSource.FromFile("PictureFill_Dog.png"))
' Specify which part of the rectangle the picture should occupy.
rectangle.Fill.PictureFill.FillRect = New RectangleOffset(0F, 0.1F, 0F, 0.1F)

Texture Fill

Set the Shape.Fill.PictureFill.Stretch property to false to tile the shape with a picture as shown below.

C#

// Create a rectangle.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new RectangleF(300, 200, 500, 350));
// Use a picture to fill the rectangle.
rectangle.Fill.SetPictureFill(DocumentImageSource.FromFile("PictureFill_Leaf.png"));
// Access picture fill settings.
PictureFill pictureFill = rectangle.Fill.PictureFill;
// Tile the picture as texture.
pictureFill.Stretch = false;
// Scale the picture to 50% of its original size.
pictureFill.ScaleX = 0.5f;
pictureFill.ScaleY = 0.5f;
// Specify the first tile position.
pictureFill.TileAlign = TileAlignType.TopLeft;
// Specify the mirror type for tiles.
pictureFill.TileFlip = TileFlipType.Vertical;

VB.NET

' Create a rectangle.
Dim rectangle As Shape = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, New RectangleF(300, 200, 500, 350))
' Use a picture to fill the rectangle.
rectangle.Fill.SetPictureFill(DocumentImageSource.FromFile("PictureFill_Leaf.png"))
' Access picture fill settings.
Dim pictureFill As PictureFill = rectangle.Fill.PictureFill
' Tile the picture as texture.
pictureFill.Stretch = False
' Scale the picture to 50% of its original size.
pictureFill.ScaleX = 0.5F
pictureFill.ScaleY = 0.5F
' Specify the first tile position.
pictureFill.TileAlign = TileAlignType.TopLeft
' Specify the mirror type for tiles.
pictureFill.TileFlip = TileFlipType.Vertical