Constructs a paginable text element that will be rendered in the specified rectangle using the specified width, height, font and color.
The Unicode text is supported only for embedded true type fonts. A flag indicating if the font is embedded or not in PDF
can be specified when the font is added to PDF document.
If the text pagination is not allowed ( Paginate property is false ), the text will be written on current page, the rendered text height
being given by the minimum between the specified height and the available height on page. The remaining text
and the text bounds inside the current page are returned in the AddTextElementResult object when the element is added
to a renderer.
If the text pagination is allowed ( Paginate property is true ) and the text needs pagination (the specified height is bigger
than the available space on page), the height parameter will be ignored and the text will be rendered to the end using the necessary
height. The text bounds inside the last page and the last page index are returned in the AddTextElementResult object when
the element is added to a renderer.
If the text pagination is allowed but the text does not need pagination (the specified height is less than the available space on page),
the rendered text will be truncated to fit the specified height. The text bounds inside the current page and the last page index are
returned in the AddTextElementResult object when the element is added to a renderer.
Namespace: Winnovative
Assembly: wnvhtmltopdf (in wnvhtmltopdf.dll) Version: 17.0.0.0
Syntax
public TextElement( float x, float y, float width, float height, string text, PdfFont font, PdfColor textColor )
Parameters
- x
- Type: SystemSingle
The start x coordinate where the text will be rendered - y
- Type: SystemSingle
The start y coordinate where the text - width
- Type: SystemSingle
The width of the destination rectangle. Use a negative value allow text to flow freely in PDF page width. - height
- Type: SystemSingle
The height of the destination rectangle. Use a negative value allow text to flow freely in PDF document. - text
- Type: SystemString
The text to be rendered - font
- Type: WinnovativePdfFont
The text font. The true type fonts must be embedded in PDF when it is added to the document in order to support Unicode texts. - textColor
- Type: WinnovativePdfColor
The text color
See Also