DrawHTMLStory

Texte HTML, disposition des pages, pagination

Description

Fait circuler une histoire HTML mise en forme de gauche à droite dans des colonnes de même largeur sur la page sélectionnée, puis dans de nouvelles pages générées

Syntaxe

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

Paramètres

Left, Top	L'origine supérieure gauche de la région de colonnes complète dans le système de coordonnées actuel
Width, Height	Dimensions positives de la région complète sur chaque page
Columns	Nombre de colonnes compris entre 1 et 64
Gutter	Espacement non négatif entre des colonnes adjacentes ; la somme des gouttières doit être inférieure à `Width`
MaxPages	Nombre maximal de pages à utiliser dans cet appel, de 1 à 10 000, page sélectionnée comprise
HTMLText	HTML initial ou chaîne de continuation renvoyée par un appel antérieur de récit ou de zone de texte

Valeurs de retour

Renvoie une chaîne vide lorsque toute l'histoire est placée, ou une chaîne de continuation contenant le contenu non placé et son état HTML/CSS actif lorsque MaxPages est atteint

Une entrée non valide renvoie HTMLText sans modification avec LastErrorCode 121 ; un échec de création de page ou deux cadres consécutifs sans progression de mise en page renvoient le récit restant avec l’erreur 524

Remarques

Les colonnes sont remplies dans l'ordre de lecture de gauche à droite avant la création d'une nouvelle page

Les pages générées copient la largeur et la hauteur effectives de la page de départ, tandis que l’unité actuelle, l’origine, les correspondances de polices HTML, liaisons d’images, styles en ligne, cascade de feuilles, pile de styles, conteneurs Flexbox et Grid, tables, liens, blocs structurés et numérotation des notes se poursuivent dans le même moteur

Utilisez <footnote> ou <aside style="float:footnote"> après le texte associé ; les notes acceptées reçoivent un marqueur en exposant, réservent une zone séparée au bas du cadre actuel et réduisent la hauteur du corps avant les sauts de ligne suivants

Si une note et sa référence ne tiennent pas ensemble, toutes deux restent dans la chaîne de continuation pour la colonne ou la page suivante

La méthode utilise des plans de mesure et de relecture mis en cache pour chaque cadre et ne concatène pas le contenu des pages dans un tampon de disposition unique sans limite

Lorsqu'une limite de page finie renvoie du contenu restant, créez ou sélectionnez la page de continuation souhaitée et transmettez la chaîne renvoyée à un autre appel

Voir aussi

DrawHTMLTextBox, DrawTextFlowColumns, Annexe A : balises HTML prises en charge