DrawHTMLStory

HTML text, page layout, pagination

Aprašymas

Prateka vieną stilizuotąjį HTML istoriją iš kairės į dešinę per lygiapločius stulpelius pasirinktajame puslapyje, o tada per naujai generuojamuosius puslapius

Sintaksė

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

Parametrai

Left, Top	Visos stulpelių srities viršutinė kairioji pradžia dabartinėje koordinačių sistemoje
Width, Height	Teigiamosios visos srities matmenys kiekviename puslapyje
Columns	Stulpelių skaičius nuo 1 iki 64
Gutter	Neneigiamasis tarpas tarp gretimųjų stulpelių; combined kanupai turi būti mažesni už `Width`
MaxPages	Didžiausiasis šiame kvietime naudojamų puslapių skaičius nuo 1 iki 10000, įskaitant pasirinktąjį puslapį
HTMLText	Pradinis HTML arba tęsimo eilutė, grąžinta ankstesnio istorijos arba teksto laukelio kvietimo

Grąžinamos reikšmės

Kai visa istorija patalpinta, grąžina tuščią eilutę, o pasiekus MaxPages – tęsimo eilutę, kurioje yra visas nepatalpintasis turinys ir jo aktyvioji HTML/CSS būsena. Netinkamoji įvestis grąžina

HTMLText nepakeistą su LastErrorCode 121; puslapių kūrimo nesėkmė arba du iš eilės kadrai be išdėstymo pažangos grąžina likusiąją istoriją su 524 klaida

Pastabos

Stulpeliai užpildomi skaitymo tvarka iš kairės į dešinę, prieš sukuriant naują puslapį

Sugeneruotieji puslapiai kopijuoja pasirinktosios pradinio puslapio faktinį plotį ir aukštį, o esamasis matavimo vienetas, pradžios taškas, HTML šriftų atvaizdavimai, vaizdų susiejimai, įterptieji stiliai, stilių lentelių kaskada, įdėtasis stilių dėklas, Flexbox ir Grid konteineriai, lentelės, nuorodos, struktūriniai blokai ir išnašų numeravimas tęsiasi per tą patį atvaizduotoją. Naudokite <footnote> arba <aside style="float:footnote"> po susijusiuoju pagrindiniu tekstu; priimtosios išnašos gauna viršutinio indekso žymeklį, rezervuoja atskirtąją sritį esamojo kadro apačioje ir mažina pagrindinio teksto aukštį prieš paskesnius eilučių lūžius. Jei išnaša ir jos nuoroda kartu netelpa, abi lieka tęsimo eilutėje kitam stulpeliui arba puslapiui

Metodas kiekvienam kadrui naudoja podėlyje saugomus matavimo ir pakartotinio atkūrimo planus ir nesujungia puslapių turinio į vieną neribotąjį išdėstymo buferį. Kai baigtinė puslapių riba grąžina likusį turinį, sukurkite arba pasirinkite pageidaujamąjį tęsimo puslapį ir grąžintąją eilutę perduokite kitam kvietimui

Taip pat žiūrėkite

DrawHTMLTextBox, DrawTextFlowColumns, Appendix A: Supported HTML tags