DrawHTMLStory

HTML-tekst, paginalay-out, paginering

Beschrijving

Stuurt één gestileerde HTML-story van links naar rechts door kolommen met gelijke breedte op de geselecteerde pagina en vervolgens door nieuw gegenereerde pagina's

Syntaxis

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

Parameters

Left, Top	De linkerbovenoorsprong van de complete kolomregio in het huidige coördinatensysteem
Width, Height	Positieve afmetingen van het volledige gebied op elke pagina
Columns	Aantal kolommen van 1 tot en met 64
Gutter	Niet-negatieve ruimte tussen aangrenzende kolommen; de gecombineerde tussenruimten moeten kleiner zijn dan `Width`
MaxPages	Maximaal aantal pagina's dat in deze aanroep wordt gebruikt, van 1 tot en met 10000, inclusief de geselecteerde pagina
HTMLText	Initiële HTML of de continuation string die door een eerdere story- of text-box-aanroep is geretourneerd

Retourwaarden

Geeft een lege string terug wanneer de volledige story is geplaatst, of een vervolgstring met alle ongeplaatste inhoud en zijn actieve HTML/CSS-status wanneer MaxPages is bereikt Ongeldige invoer geeft terug

HTMLText ongewijzigd met LastErrorCode 121; een mislukte pagina-aanmaak of twee opeenvolgende frames zonder layoutvoortgang geeft de resterende story terug met fout 524

Opmerkingen

Kolommen worden in leesvolgorde van links naar rechts gevuld voordat een nieuwe pagina wordt gemaakt

Gegenereerde pagina's kopieren de effectieve breedte en hoogte van de geselecteerde startpagina, terwijl de huidige meeteenheid, oorsprong, HTML-fonttoewijzingen, afbeeldingskoppelingen, inline stijlen, de stylesheetcascade, de geneste stijlstack, Flexbox- en Grid-containers, tabellen, koppelingen, gestructureerde blokken en de voetnotennummering door dezelfde renderer lopen

Gebruik <footnote> of <aside style="float:footnote"> na de bijbehorende brontekst; geaccepteerde notities krijgen een superscript-marker, reserveren een afgescheiden gebied onderaan het huidige frame en verkleinen de bodyhoogte vóór de daaropvolgende regelafbreking

Als een notitie en haar verwijzing niet samen passen, blijven beide in de vervolgstring voor de volgende kolom of pagina

De methode gebruikt gecachte meet-en-afspeelplannen per frame en voegt pagina-inhoud niet samen tot één onbegrensde layoutbuffer

Wanneer een eindige paginalimiet resterende inhoud teruggeeft, maak of selecteer dan de gewenste vervolgpagina en geef de geretourneerde string door aan een volgende aanroep

Zie ook

DrawHTMLTextBox, DrawTextFlowColumns, Bijlage A: Ondersteunde HTML-tags