DrawTableRows
چیدمان صفحه
توضیحات
چندین سطر از جدول مشخصشده را روی صفحهٔ انتخابشده رسم میکند و ارتفاع کل سطرهای رسمشده را برمیگرداند
فقط تعداد سطرهایی که در ارتفاع مشخصشده جا میشوند رسم میشوند. از
تابع GetTableLastDrawnRow برای تعیین شمارهٔ آخرین سطر ترسیمشده.
مقدار بازگرداندهشده توسط این تابع مطابق تنظیمات فعلی دستگاه مختصات که توسط تابع SetMeasurementUnits تنظیم شده مقیاس میگیرد
نحو
Delphi
Function TPDFlib.DrawTableRows(TableID: Integer; Left, Top, Height: Double; FirstRow, LastRow: Integer): Double;
ActiveX
Function PDFlib::DrawTableRows(TableID As Long, Left As Double, Top As Double, Height As Double, FirstRow As Long, LastRow As Long) As Double
DLL
double DLDrawTableRows(int InstanceID, int TableID, double Left, double Top, double Height, int FirstRow, int LastRow);
پارامترها
| TableID | یک TableID که توسط تابع CreateTable بازگردانده میشود |
|---|---|
| Left | فاصلهٔ افقی از مبدأ تا لبهٔ چپ جدول |
| Top | فاصلهٔ عمودی از مبدأ تا بالای جدول حداکثر ارتفاع موجود برای رسم جدول |
| Height | |
| FirstRow | شمارهٔ اولین سطر برای رسم؛ بالاترین سطر، سطر شمارهٔ 1 است |
| LastRow | 0 = همه ردیفهای باقیمانده Non-zero = شماره آخرین ردیفی که باید تنظیم شود |
مقادیر بازگشتی
| 0 | No rows were drawn |
|---|---|
| Non-zero | ارتفاع کل همه ردیفهایی که روی صفحه ترسیم شدهاند |
ملاحظات
وقتی table tagging فعال است (به SetAutoTagMode مراجعه کنید)، table، ردیفها و cellهای آن همانطور که ترسیم میشوند وارد درخت ساختار میشوند و ردیفهایی که با SetTableHeaderRowCount نامگذاری شدهاند به cellهای header تبدیل میشوند. خروجی ترسیمشده در هر دو حالت یکسان است. در اینجا چیزی در بالای صفحه ادامه تکرار نمیشود؛ برای این کار از DrawTaggedTableRows استفاده کنید