How to: Insert a Picture

• Aug 05, 2019

The RichEditControl supports the following graphic types:

• Bitmap (*.bmp, *.dib)
• JPEG File Interchange Format (*.jpg, *.jpeg)
• Portable Network Graphics (*.png)
• Graphics Interchange Format (*.gif)
• Tagged Image Format (*.tif, *.tiff)
• Microsoft Enhanced Metafile (*.emf)
• Windows Metafile (*.wmf)

Use the following API to place an image in the document:

API	Description
DocumentImageCollection.Append	Appends an image.
DocumentImageCollection.Insert ShapeCollection.InsertPicture	Inserts an image in the specified position.

The code sample belows inserts an image at the document’s start.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/winforms-richedit-document-api-e5219

InlinePictures.cs

DocumentPosition pos = document.Range.Start;
document.Images.Insert(pos, DocumentImageSource.FromFile("beverages.png"));

InlinePictures.vb

Dim pos As DocumentPosition = document.Range.Start
document.Images.Insert(pos, DocumentImageSource.FromFile("beverages.png"))

The created DocumentImage object is added to two collections: ShapeCollection and DocumentImageCollection The object’s Shape.TextWrapping property will be set to TextWrappingType.InLineWithText

The code sample below inserts an image in the specified position. The resulting object is added to the ShapeCollection only.

C#

document.AppendText("Line One\nLine Two\nLine Three");
Shape myPicture = document.Shapes.InsertPicture(document.CreatePosition(15), 
    System.Drawing.Image.FromFile("beverages.png"));
myPicture.HorizontalAlignment = ShapeHorizontalAlignment.Center;

VB.NET

document.AppendText("Line One" & vbLf & "Line Two" & vbLf & "Line Three")
Dim myPicture As Shape = document.Shapes.InsertPicture(document.CreatePosition(15), System.Drawing.Image.FromFile("beverages.png"))
myPicture.HorizontalAlignment = ShapeHorizontalAlignment.Center