DrawHTMLStory

HTML-Text, Seitenlayout, Paginierung

Beschreibung

Leitet eine formatierte HTML-Story von links nach rechts durch gleich breite Spalten auf der ausgewählten Seite und anschließend durch neu erzeugte Seiten

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

Parameter

Left, Top	Der linke obere Ursprung des vollständigen Spaltenbereichs im aktuellen Koordinatensystem
Width, Height	Positive Abmessungen des vollständigen Bereichs auf jeder Seite
Columns	Spaltenanzahl von 1 bis 64
Gutter	Nicht negativer Abstand zwischen benachbarten Spalten; die Summe der Zwischenräume muss kleiner als `Width` sein
MaxPages	Maximale Anzahl der in diesem Aufruf zu verwendenden Seiten von 1 bis 10000 einschließlich der ausgewählten Seite
HTMLText	Ursprüngliches HTML oder die von einem früheren Story- oder Textfeldaufruf zurückgegebene Fortsetzungszeichenfolge

Rückgabewerte

Gibt eine leere Zeichenfolge zurück, wenn die gesamte Story platziert wurde, oder bei Erreichen von MaxPages eine Fortsetzungszeichenfolge mit sämtlichen nicht platzierten Inhalten und deren aktivem HTML/CSS-Zustand

Bei ungültiger Eingabe wird HTMLText unverändert mit LastErrorCode 121 zurückgegeben; bei einem Fehler der Seitenerstellung oder zwei aufeinanderfolgenden Frames ohne Layoutfortschritt wird der verbleibende Text mit Fehler 524 zurückgegeben

Anmerkungen

Spalten werden in Lesereihenfolge von links nach rechts befüllt, bevor eine neue Seite erstellt wird

Erzeugte Seiten übernehmen die effektive Breite und Höhe der ausgewählten Startseite. Aktuelle Maßeinheit, Ursprung, HTML-Schriftzuordnungen, Bildbindungen, Inline-Stile, Stylesheet-Kaskade, verschachtelter Stilstapel, Flexbox- und Grid-Container, Tabellen, Links, strukturierte Blöcke und Fußnotennummerierung werden im selben Renderer fortgeführt

Verwenden Sie <footnote> oder <aside style="float:footnote"> nach dem zugehörigen Haupttext; akzeptierte Notizen erhalten eine hochgestellte Markierung, reservieren einen getrennten Bereich am unteren Rand des aktuellen Rahmens und verringern die Texthöhe vor dem weiteren Zeilenumbruch

Wenn eine Notiz und ihr Verweis nicht zusammen passen, verbleiben beide in der Fortsetzungszeichenfolge für die nächste Spalte oder Seite

Die Methode verwendet zwischengespeicherte Mess- und Wiedergabepläne für jeden Frame und verkettet Seiteninhalte nicht zu einem einzigen unbegrenzten Layoutpuffer

Wenn bei einer endlichen Seitenbegrenzung Restinhalt zurückgegeben wird, erstellen oder wählen Sie die gewünschte Fortsetzungsseite und übergeben Sie die zurückgegebene Zeichenfolge an einen weiteren Aufruf

Siehe auch

DrawHTMLTextBox, DrawTextFlowColumns, Anhang A: Unterstützte HTML-Tags