Skip to main content

ShapeCollection.InsertPicture(DocumentPosition, DocumentImageSource) Method

Inserts a picture in the document.

Namespace: DevExpress.XtraRichEdit.API.Native

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

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


Shape InsertPicture(
    DocumentPosition pos,
    DocumentImageSource imageSource


Name Type Description
pos DocumentPosition

The position of the picture’s anchor.

imageSource DocumentImageSource

An object that specifies the image source.


Type Description

The picture embedded in the document.


The InsertPicture method positions a floating picture at the top-left corner of the page that contains the picture’s anchor. The TextWrapping property is set to InFrontOfText.

The Word Processing Document API and Rich Text Editors support the following image 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)
  • Scalable Vector Graphics (*.svg)

The example below inserts a picture and specifies its horizontal alignment.

Document document = wordProcessor.Document;
document.AppendText("Line One\nLine Two\nLine Three");
Shape myPicture = document.Shapes.InsertPicture(document.CreatePosition(15),
myPicture.HorizontalAlignment = ShapeHorizontalAlignment.Center;

The following code snippets (auto-collected from DevExpress Examples) contain references to the InsertPicture(DocumentPosition, DocumentImageSource) method.


The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also