Edit this page
Available for: UI for ASP.NET AJAX | UI for ASP.NET MVC | UI for WPF | UI for WinForms

ImageInline

ImageInline element is an inline-level flow content element intended to contain an image object.

Inserting an ImageInline

Example 1 demonstrates how you can create an ImageInline and add it to a Paragraph:

[C#] Example 1: Create an image inline and insert it in a paragraph

ImageInline imageInline = new ImageInline(document);
paragraph.Inlines.Add(imageInline);

The parent Paragraph should belong to the same document that is passed to the constructor of the ImageInline.

You can add an image at a specific index in the Inlines collection of a paragraph using the Insert() method. Here is how to add an ImageInline at the beginning of a paragraph:

[C#] Example 2: Add an image inline to a specific position

ImageInline imageInline = new ImageInline(document);
paragraph.Inlines.Insert(0, imageInline);

You can also use the AddImageInline() method of the Inlines collection of a paragraph. The method creates a new ImageInline, adds it to the paragraph and returns it.

[C#] Example 3: Using AddImageInline() method

ImageInline imageInline = paragraph.Inlines.AddImageInline();

Inserting ImageInline element in RadFlowDocument can also be achieved with RadFlowDocumentEditor.

[C#] Example 4: Insert an image inline using RadFlowDocumentEditor

RadFlowDocumentEditor editor = new RadFlowDocumentEditor(document);

using (Stream stream = this.GetResourceStream("Telerik_logo.png"))
{
    editor.InsertImageInline(stream, "png", new Size(118, 28));
}

Modifying an ImageInline

The ImageInline element exposes the following properties:

  • Image: Represents the image object that is contained in the ImageInline. It is a read-only composite object that contains the properties listed below:

    • ImageSource: Specifies the image source that is visualized in the image object.
    • Name: Represents the name of the image.
    • Width: The width of the image.
    • Height: The height of the image.
    • Size: The size of the image. Can also be set to Size.Empty.
    • IsHorizontallyFlipped: Specifies whether the image is horizontally flipped.
    • IsVerticallyFlipped: Specifies whether the image is vertically flipped.
    • RotationAngle: Specifies the rotation angle of the image.
    • LockAspectRatio: Determines whether the aspect ratio between the width and the height of the image will be preserved.

Working with Image Size

This section explains the behavior of the Size property of The Image object in an ImageInline and how the image sizes are exported to the supported formats.

  • Insert image without specifying its size

    • Model: Size will be Size.Empty.
    • Export to DOCX: Size will be decoded
    • Export to RTF: Size will be decoded
    • Export HTML: Width and height attributes will not be exported
  • Insert image and set its size to Size.Empty

    • Model: Size will be Size.Empty
    • Export to DOCX: Size will be (1,1)
    • Export to RTF: Size will be (1,1)
    • Export to HTML: Width and height attributes will not be exported
  • Inserting image without specifying its size and obtain its size later (through the property getter)

    • Model: Size will be decoded

See Also