DrawHTMLStory

Testo HTML, layout di pagina, impaginazione

Descrizione

Fa scorrere una storia HTML con stile da sinistra a destra attraverso colonne di uguale larghezza sulla pagina selezionata e poi attraverso nuove pagine generate

Sintassi

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

Parametri

Left, Top	Origine superiore sinistra dell'intera regione delle colonne nel sistema di coordinate corrente
Width, Height	Dimensioni positive dell'intera regione in ogni pagina
Columns	Numero di colonne da 1 a 64
Gutter	Spaziatura non negativa tra colonne; la somma degli spazi deve essere minore di `Width`
MaxPages	Numero massimo di pagine da usare in questa chiamata da 1 a 10000, inclusa la pagina selezionata
HTMLText	HTML iniziale oppure stringa di continuazione restituita da una chiamata precedente a una storia o casella di testo

Valori restituiti

Restituisce una stringa vuota quando l'intero contenuto è stato disposto oppure una stringa di continuazione contenente tutto il contenuto non disposto e il relativo stato HTML/CSS attivo quando viene raggiunto MaxPages

Un input non valido restituisce HTMLText invariato con LastErrorCode 121; un errore di creazione della pagina o due frame consecutivi senza avanzamento del layout restituiscono la storia rimanente con errore 524

Note

Le colonne vengono riempite nell'ordine di lettura da sinistra a destra prima di creare una nuova pagina

Le pagine generate copiano la larghezza e l'altezza effettive della pagina iniziale selezionata, mentre l'unità di misura corrente, l'origine, le mappature dei font HTML, le associazioni delle immagini, gli stili inline, la cascata dei fogli di stile, lo stack degli stili annidati, i contenitori Flexbox e Grid, le tabelle, i collegamenti, i blocchi strutturati e la numerazione delle note a piè di pagina proseguono attraverso lo stesso renderer

Usare <footnote> o <aside style="float:footnote"> dopo il testo correlato; le note accettate ricevono un indicatore in apice, riservano un'area separata in fondo al frame e riducono l'altezza del corpo prima dei successivi ritorni a capo

Se nota e riferimento non rientrano insieme, restano nella continuazione per la colonna o pagina successiva

Il metodo usa piani di misurazione e riproduzione nella cache per ogni frame e non concatena il contenuto delle pagine in un unico buffer di layout illimitato

Quando un limite finito restituisce contenuto restante, creare o selezionare la pagina di continuazione e passare la stringa restituita a un'altra chiamata

Vedere anche

DrawHTMLTextBox, DrawTextFlowColumns, Appendix A: Supported HTML tags