DrawHTMLStory

Tekst HTML, układ strony, paginacja

Opis

Przepływa jedną sformatowaną historię HTML od lewej do prawej przez kolumny o równej szerokości na wybranej stronie, a następnie przez nowo wygenerowane strony

Składnia

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

Parametry

Left, Top	Lewy górny początek całego obszaru kolumn w bieżącym układzie współrzędnych
Width, Height	Dodatnie wymiary całego obszaru na każdej stronie
Columns	Liczba kolumn od 1 do 64
Gutter	Nieujemny odstęp między sąsiednimi kolumnami; łączna szerokość odstępów musi być mniejsza niż `Width`
MaxPages	Maksymalna liczba stron używanych w tym wywołaniu, od 1 do 10000, wliczając wybraną stronę
HTMLText	Początkowy kod HTML albo ciąg kontynuacji zwrócony przez wcześniejsze wywołanie historii lub pola tekstowego

Wartości zwracane

Zwraca pusty ciąg po umieszczeniu całej historii albo ciąg kontynuacji zawierający całą nieumieszczoną zawartość i jej aktywny stan HTML/CSS po osiągnięciu MaxPages

Nieprawidłowe dane wejściowe zwracają HTMLText bez zmian i ustawiają LastErrorCode na 121; błąd tworzenia strony lub dwie kolejne ramki bez postępu układu zwracają pozostałą historię z błędem 524

Uwagi

Kolumny są wypełniane w kolejności czytania od lewej do prawej przed utworzeniem nowej strony

Wygenerowane strony kopiują efektywną szerokość i wysokość wybranej strony początkowej, natomiast bieżąca jednostka miary, początek układu współrzędnych, mapowania czcionek HTML, powiązania obrazów, style inline, kaskada arkuszy stylów, zagnieżdżony stos stylów, kontenery Flexbox i Grid, tabele, łącza, bloki strukturalne oraz numeracja przypisów są kontynuowane przez ten sam renderer

Użyj <footnote> lub <aside style="float:footnote"> po powiązanym tekście głównym; zaakceptowane przypisy otrzymują znacznik w indeksie górnym, rezerwują oddzielony obszar u dołu bieżącej ramki i zmniejszają wysokość tekstu głównego przed dalszym łamaniem wierszy

Jeśli przypis i jego odwołanie nie mieszczą się razem, oba pozostają w ciągu kontynuacji dla następnej kolumny lub strony

Metoda używa buforowanych planów pomiaru i odtwarzania dla każdej ramki i nie łączy zawartości stron w jeden nieograniczony bufor układu

Gdy skończony limit stron powoduje zwrócenie pozostałej zawartości, utwórz lub wybierz żądaną stronę kontynuacji i przekaż zwrócony ciąg do kolejnego wywołania

Zobacz również

DrawHTMLTextBox, DrawTextFlowColumns, Appendix A: Supported HTML tags