DrawHTMLStory

HTML metni, sayfa düzeni, sayfalandırma

Açıklama

Biçimlendirilmiş bir HTML öyküsünü seçili sayfada ve yeni oluşturulan sayfalarda eşit genişlikli sütunlar boyunca soldan sağa akıtır

Sözdizimi

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

Parametreler

Left, Top	Geçerli koordinat sisteminde tam sütun bölgesinin sol üst başlangıcı
Width, Height	Her sayfadaki tam bölgenin pozitif boyutları
Columns	1 ile 64 arasındaki sütun sayısı
Gutter	Bitişik sütunlar arasındaki negatif olmayan boşluk; birleşik oluklar `Width` değerinden küçük olmalıdır
MaxPages	Seçili sayfa dahil bu çağrıda kullanılacak, 1 ile 10000 arasındaki azami sayfa sayısı
HTMLText	İlk HTML veya önceki bir hikâye ya da metin kutusu çağrısının döndürdüğü devam dizesi

Dönüş değerleri

Hikâyenin tamamı yerleştirildiğinde boş bir dize, MaxPages değerine ulaşıldığında ise yerleştirilmemiş tüm içeriği ve etkin HTML/CSS durumunu içeren bir devam dizesi döndürür

Geçersiz giriş HTMLText değerini değiştirmeden, LastErrorCode 121 ile döndürür; sayfa oluşturma hatası veya düzen ilerlemesi olmayan iki ardışık çerçeve, kalan öyküyü 524 hatasıyla döndürür

Açıklamalar

Yeni sayfa oluşturulmadan önce sütunlar soldan sağa okuma sırasıyla doldurulur

Oluşturulan sayfalar seçili başlangıç sayfasının etkili genişlik ve yüksekliğini kopyalarken geçerli ölçü birimi, başlangıç noktası, HTML yazı tipi eşlemeleri, görüntü bağlamaları, satır içi stiller, stil sayfası basamaklandırması, iç içe stil yığını, Flexbox ve Grid kapsayıcıları, tablolar, bağlantılar, yapılandırılmış bloklar ve dipnot numaralandırması aynı işleyicide devam eder

İlgili gövde metninden sonra <footnote> veya <aside style="float:footnote"> kullanın; kabul edilen notlar üst simge işaretçisi alır, geçerli çerçevenin altında ayrılmış bir alan kullanır ve sonraki satır bölmeden önce gövde yüksekliğini azaltır

Bir not ve başvurusu birlikte sığmazsa ikisi de sonraki sütun veya sayfa için devam dizesinde kalır

Yöntem her çerçeve için önbelleğe alınmış ölçme ve yeniden oynatma planlarını kullanır ve sayfa içeriğini sınırsız tek bir düzen arabelleğinde birleştirmez

Sonlu bir sayfa sınırı kalan içeriği döndürdüğünde istenen devam sayfasını oluşturun veya seçin ve döndürülen dizeyi başka bir çağrıya iletin

Ayrıca bkz

DrawHTMLTextBox, DrawTextFlowColumns, Ek A: Desteklenen HTML etiketleri