DrawHTMLStory

HTML-text, sidlayout, sidbrytning

Beskrivning

Flyter en formaterad HTML-story från vänster till höger genom likabredda kolumner på den valda sidan och därefter genom nyskapade sidor

Syntax

Delphi

Function TPDFlib.DrawHTMLStory(Left, Top, Width, Height: Double; Columns: Integer; Gutter: Double; MaxPages: Integer; Const HTMLText: WideString): WideString;

DLL

const wchar_t* DLDrawHTMLStory(int InstanceID, double Left, double Top, double Width, double Height, int Columns, double Gutter, int MaxPages, const wchar_t* HTMLText);

ActiveX

Function PDFlib::DrawHTMLStory(Left As Double, Top As Double, Width As Double, Height As Double, Columns As Long, Gutter As Double, MaxPages As Long, HTMLText As String) As String

Parametrar

Left, Top	Den fullständiga kolumnregionens övre vänstra origo i aktuellt koordinatsystem
Width, Height	Positiva dimensioner för den fullständiga regionen på varje sida
Columns	Antal kolumner från 1 till 64
Gutter	Icke-negativt mellanrum mellan intilliggande kolumner; de kombinerade mellanrummen måste vara mindre än `Width`
MaxPages	Maximalt antal sidor att använda i det här anropet, från 1 till 10000, inklusive den valda sidan
HTMLText	Ursprunglig HTML eller fortsättningssträngen som ett tidigare story- eller textrutanrop returnerade

Returvärden

Returnerar en tom sträng när hela storyn placerats, eller en fortsättningssträng som innehåller allt oplacerat innehåll och dess aktiva HTML/CSS-tillstånd när MaxPages nåttsOgiltig indata returnerar

HTMLText oförändrat med LastErrorCode 121; ett misslyckat sidskapande eller två rader i rad utan layoutframsteg returnerar den återstående storyn med fel 524

Anmärkningar

Kolumner fylls i läsordning från vänster till höger innan en ny sida skapas

Genererade sidor ärver den valda startsidans effektiva bredd och höjd, medan aktuell måttenhet, origo, HTML-typsnittsmappningar, bildbindningar, inline-stilar, stilmallskaskad, kapslad stilstack, Flexbox- och Grid-containers, tabeller, länkar, strukturerade block och fotnotsnumrering fortsätter genom samma renderare

Använd <footnote> eller <aside style="float:footnote"> efter tillhörande brödtext; accepterade noter får en upphöjd markör, reserverar ett avskilt område längst ner i aktuellt ram och minskar brödtextens höjd innan nästa radbrytning

Om en not och dess referens inte får plats tillsammans hamnar båda kvar i fortsättningssträngen för nästa kolumn eller sida

Metoden använder cachade mät-och-spela-upp-planer för varje ram och konkatenerar inte sidinnehåll till en enda obegränsad layoutbuffer

När en ändlig sidogräns returnerar återstående innehåll skapar eller väljer du önskad fortsättningssida och skickar den returnerade strängen till ett nytt anrop

Se även

DrawHTMLTextBox, DrawTextFlowColumns, Appendix A: Supported HTML tags