DrawHTMLTextBox

Text, HTML text, Page layout

Description

Similar to the DrawHTMLText function, but the text drawn is limited to a specific area. The remaining HTML text is returned, which can be passed to this function again (perhaps on a different page or location) until the function returns an empty string. See Appendix A for details of the supported HTML tags

Syntax

Delphi

Function TPDFlib.DrawHTMLTextBox(Left, Top, Width, Height: Double; Const HTMLText: WideString): WideString;

ActiveX

Function PDFlib::DrawHTMLTextBox(Left As Double, Top As Double, Width As Double, Height As Double, HTMLText As String) As String

DLL

const wchar_t * DLDrawHTMLTextBox(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * HTMLText);

Parameters

LeftHorizontal coordinate of the left edge of the drawing area
TopVertical coordinate of the top edge of the drawing area
WidthThe width of the drawing area
HeightThe height of the drawing area
HTMLTextThe HTML text to draw

Return values

LeftOverTextHTML containing the text that did not fit into the text box; pass it to another text box, often on the next page

Layout support

Flexbox and CSS Grid containers are measured within the box and participate in cached layout replay

Footnotes declared with <footnote> or <aside style="float:footnote"> reserve a separated area at the frame bottom; a note that cannot fit with its reference is returned in LeftOverText

Remarks

Returned HTML preserves literal entity spellings and escaped angle brackets when passed to another text box