New to Telerik UI for WPF? Download free 30-day trial

Shapes

The Shapes feature allows you to easily insert shapes like circles, boxes, arrows, and many others directly in your documents. You can style the inserted shapes by using gradient fills and various patterns outlines, as well as changing the size of the shapes and rotating them.

Currently, RadRichTextBox supports the import and export of shapes from and to Office Open XML (DOCX). When exporting to PDF, the shapes are converted to images. When exporting to other formats the shapes will be lost.

Working with Shapes

RadRichTextBox enables you to insert, edit and delete shapes through its API and UI.

Insert shape in Telerik RadRichTextBox for WPF

In the Insert tab, you will find a list containing various predefined shapes you can choose between. Once you insert a shape into the document, you can modify its settings and appearance so you can achieve the desired look of your document. Following is a list of the appearance settings you can modify for a shape:

  • rotation

    Rotate shape in Telerik RadRichTextBox for WPF

  • position

  • size

  • fill

  • borders

  • adjust values (to customize the geometry of the shape)

    Adjust shape in Telerik RadRichTextBox for WPF

Shapes containing text are not supported in the current version.

Inserting Shapes in Code

The InsertShape() method of RadDocumentEditor enables you to insert a shape object at the current caret position. The method accepts the shape type and the initial shape size values as parameters.

Example 1: Insert shape in a document

RadDocumentEditor editor = new RadDocumentEditor(this.radRichTextBox.Document); 
editor.InsertShape(ShapeType.Heart, new Size(100, 100)); 

Editing Shapes in Code

The RadDocumentEditor class exposes several methods related to modifying different shape properties. To use them, you should find the shape that you would like to modify.

Example 2: Getting all shapes in a document

IEnumerable<ShapeInline> shapes = this.radRichTextBox.Document.EnumerateChildrenOfType<ShapeInline>(); 
Once you have obtained the desired ShapeInline, you can apply the changes to it through the exposed methods:
  • ChangeShapeSize(ShapeInline shape, Size size): Changes the size of the specified shape.
  • ChangeShapeRotateAngle(ShapeInline shape, double angle): Changes the rotation of the specified shape.
  • AdjustShape(ShapeInline shape, IEnumerable updatedGuides): Modifies the guides used to draw the shape figure.
  • ChangeShapeOutlineDash(ShapeInline shape, LineDashType dashType): Changes the dashing pattern of a shape outline.
  • ChangeShapeOutlineFill(ShapeInline shape, IShapeOutlineFill lineFill): Changes the fill of a shape outline.
  • ChangeShapeOutlineWidth(ShapeInline shape, double width): Changes the width of the specified shape's outline.
  • ChangeShapeFill(ShapeInline shape, IShapeFill fill): Changes the fill of the specified shape.

Example 3: Insert and modify shape

RadDocumentEditor editor = new RadDocumentEditor(this.radRichTextBox.Document); 
editor.InsertShape(ShapeType.ArrowPentagon, new Size(100, 100)); 
 
ShapeInline shape = this.radRichTextBox.Document.EnumerateChildrenOfType<ShapeInline>().First(); 
editor.ChangeShapeOutlineDash(shape, LineDashType.DashDot); 
editor.ChangeShapeOutlineFill(shape, new ShapeSolidFill(Colors.Chocolate)); 
editor.ChangeShapeOutlineWidth(shape, 3); 
editor.ChangeShapeRotateAngle(shape, 99); 

Shape Fill

The fill colors related to shapes are defined by two interfaces: IShapeFill and IShapeOutlineFill. IShapeOutlineFill derives from IShapeFill. All fill colors implementing IShapeOutlineFill can be applied on shapes and on their outlines.

Shape Fill definitions in Telerik RadRichTextBox for WPF

Example 4: Create different fill types

ShapeNoFill noFill = new ShapeNoFill();   
ShapeSolidFill solidFill = new ShapeSolidFill(Colors.Green); 
ShapePatternFill patternFill = new ShapePatternFill(Telerik.Windows.Documents.Model.DrawingML.PatternType.Cross, Colors.White, Colors.Green); 
ShapeGradientFill gradientFill = new ShapeGradientFill(new RadialGradientBrush(Colors.White, Colors.Green)); 

See Also

In this article
Not finding the help you need? Improve this article