DrawHTMLStory

متن HTML، طرح‌بندی صفحه، صفحه‌بندی

توضیحات

یک story HTML سبک‌دار را در صفحه انتخاب‌شده از چپ به راست از میان ستون‌های هم‌عرض عبور می‌دهد و سپس از میان صفحه‌های تازه‌تولیدشده ادامه می‌دهد

نحو

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

پارامترها

مقادیر بازگشتی

وقتی کل داستان قرار گرفته باشد رشتهٔ خالی برمی‌گرداند، یا رشتهٔ ادامه حاوی همهٔ محتوای قرارنگرفته و وضعیت فعلی HTML/CSS آن وقتی MaxPages پر شودورودی نامعتبر مقدار را برمی‌گرداند

HTMLText بدون تغییر با LastErrorCode برابر 121؛ شکست ساخت صفحه یا دو قاب متوالی بدون پیشرفت layout، بخش باقی‌ماندهٔ داستان را با خطای 524 برمی‌گرداند

ملاحظات

پیش از ایجاد صفحه جدید، ستون‌ها به‌ترتیب خواندن از چپ به راست پر می‌شوند

صفحات تولیدشده عرض و ارتفاع مؤثر صفحهٔ شروع انتخاب‌شده را کپی می‌کنند، در حالی که واحد اندازه‌گیری جاری، مبدأ، نگاشت‌های فونت HTML، اتصال‌های تصویر، استایل‌های درون‌خطی، آبشار stylesheet، پشتهٔ استایل تودرتو، کانتینرهای Flexbox و Grid، جدول‌ها، پیوندها، بلوک‌های ساخت‌یافته و شماره‌گذاری پانویس از طریق همان رندرکننده ادامه می‌یابنداز <footnote> یا <aside style="float:footnote"> بعد از متن بدنهٔ مربوطه استفاده کنید؛ یادداشت‌های پذیرفته‌شده نشانگر بالانویس می‌گیرند، ناحیهٔ جداگانه‌ای در پایین قاب فعلی رزرو و ارتفاع بدنه را پیش از شکستن خطوط بعدی کم می‌کننداگر یادداشت و ارجاعش با هم جا نشوند هر دو در رشتهٔ ادامه برای ستون یا صفحهٔ بعد می‌مانند

متد برای هر قاب از طرح‌های نهان‌شدهٔ اندازه‌گیری-و-بازپخش استفاده می‌کند و محتوای صفحه را در یک بافر layout بی‌کران به هم نمی‌چسباندوقتی حد صفحهٔ محدودی محتوای باقی‌مانده برگرداند، صفحهٔ ادامهٔ دلخواه را بسازید یا انتخاب کنید و رشتهٔ برگردانده‌شده را به فراخوانی دیگری بدهید

همچنین ببینید

DrawHTMLTextBox، DrawTextFlowColumns، Appendix A: Supported HTML tags