Skip to main content
All docs
V25.1
  • ShapeCollection.InsertCanvas(DocumentPosition, RectangleF) Method

    Inserts a drawing canvas at the specified position in the document.

    Namespace: DevExpress.XtraRichEdit.API.Native

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

    NuGet Package: DevExpress.RichEdit.Core

    Declaration

    Shape InsertCanvas(
        DocumentPosition pos,
        RectangleF bounds
    )

    Parameters

    Name Type Description
    pos DocumentPosition

    The position of the canvas anchor.

    bounds RectangleF

    An object that specifies the canvas size and location (relative to the top and left edges of the page). The Document.Unit property defines the measurement units.

    Returns

    Type Description
    Shape

    The canvas embedded in the document.

    Remarks

    The example below creates a drawing canvas and places it on the page as follows:

    • the absolute horizontal position is 1.5 inches to the right of the page;

    • the absolute vertical position is one inch below the page.

    Use the Shape.CanvasItems property to access the collection of canvas items. The collection’s Add methods allow you to add shapes and pictures to the canvas.

    The example below adds a drawing canvas to the document.

    Add a canvas to ShapeCollection

    Document document = wordProcessor.Document;
    // Set the measurement unit to inches.
    document.Unit = DevExpress.Office.DocumentUnit.Inch;
    // Insert a drawing canvas.
    Shape canvas = document.Shapes.InsertCanvas(document.Range.Start, new RectangleF(1.5f, 1f, 6f, 1.5f));
    // Access the collection of canvas items. 
    var canvasItems = canvas.CanvasItems;
    // Add a rectangle to the canvas.
    var shape1 = canvasItems.AddShape(ShapeGeometryPreset.Rectangle, new RectangleF(0f, 0f, 2f, 1.5f));
    shape1.Fill.SetSolidFill(Color.FromArgb(0xA4, 0xFF, 0xFF));
    shape1.Line.Color = Color.DarkGray;
    shape1.Line.Thickness = 2;
    // Add a picture to the canvas.
    var shape2 = canvasItems.AddPicture(DocumentImageSource.FromFile("Picture_Arrow.png"), new PointF(2.1f, 0.3f));
    // Add a parallelogram to the canvas.
    var shape3 = canvasItems.AddShape(ShapeGeometryPreset.Parallelogram, new RectangleF(3.8f, 0f, 2f, 1.5f));
    shape3.Fill.SetSolidFill(Color.FromArgb(0xFF, 0xA5, 0xA5));
    shape3.Line.Color = Color.DarkGray;
    shape3.Line.Thickness = 2;
    
    See Also