paragraph

This element is used to combine text and images.

Syntax

The element declaration begins with ?paragraph=[name] statement and ends with &paragraph statement. These statements must be placed on separate lines.

name property is used as a reminder of the paragraph’s purpose; for example, “Important notice”. This is an optional property - you can use the same name for multiple paragraphs or just omit it. The name is not displayed on the form.

Attributes

The paragraph element can be customized by adding optional attributes to it.

An attribute is written as [attribute_name]=[value]. Each attribute must be placed on a new line immediately after the opening ?paragraph= statement or another attribute, and must begin with a tab character.

Attribute Default value Description Usage example
type normal Defines how paragraph elements are rendered:
  • ImageWrap - wrap text around the image.
  • inline - place all paragraph elements on the same line.
Omitting this attribute or setting it to normal will cause the text to overlay the image.
type=ImageWrap
vertical_align center Controls how inline elements of different sizes align vertically within the lines of a paragraph:
  • top - the elements are aligned with the top of the tallest element on the line.
  • center - smaller elements are placed in the middle of the line.
  • bottom - the bottom of the elements are aligned with the bottom of the entire line.
If all paragraph elements have the same height, this property does not visually apply.
vertical_align=top

Image wrapping

To allow the text to wrap around an image:

  1. Set the width, height, x and y attributes of the image element.
  2. Set the type attribute of the paragraph element to ImageWrap.

Allowed child elements

Examples

Check out the code examples to see how paragraph elements can be used.

Multi-line paragraph

?container=Example
?block=
?paragraph=Raven
?content=The Raven by Edgar Allan Poe
	font_style=Bold
	font_size=16
?empty_line=
?content=Once upon a midnight dreary, while I pondered, weak and weary,
?content=Over many a quaint and curious volume of forgotten lore-
?content=While I nodded, nearly napping, suddenly there came a tapping,
	font_style=italic
?content=As of some one gently rapping, rapping at my chamber door.
	font_style=italic
&paragraph
&block
&container

Multi-line paragraph

Text with image

?container=Example
?block=
?paragraph=
	type=ImageWrap
?image=logo.jpg
	x=1000
	y=200
	height=175
	width=200
?content=Aspose.OMR Cloud
	font_family=Arial
	font_style=Bold
	font_size=16
?content=is an easy-to-use, versatile, and cost-effective API for designing, rendering and recognizing hand-filled forms.
&paragraph
&block
&container

Text with image