THPDFTable – פריסת טבלאות ורינדור

THPDFTable הוא מנוע פריסת טבלאות ורינדור קל משקל שהוצג ב-v2.429.0 ונחשף דרך יחידת HPDFTable

לפני v2.429.0 יוצרי מסמכים נאלצו לצייר תאים ביד עם Rectangle ו-TextOut וקואורדינטות X של עמודות מקודדות-קשיח, תוך ניהול ידני של גבהי שורות, פסי זברה ומעברי עמודים; THPDFTable מניע את פרימיטיבי הציור הקיימים של THPDFPage, כך שטבלאות מרונדרות עם גבהי שורות ממודדים, תאים ממוזגים והמשכה אוטומטית במעבר עמוד

יחידה

HPDFTable

דוגמת שימוש

uses
  HPDFTable;

var
  Tbl: THPDFTable;
  Row: THPDFTableRow;
begin
  Tbl:= THPDFTable.Create(HPDF);
  try
    Tbl.AddColumn(80); Tbl.AddColumn(200); Tbl.AddColumn(120);
    Tbl.SetBounds(50, 60);
    Row:= Tbl.AddRow; Row.IsHeader:= True;
    Row.Cells[0].Text:= 'No';
    Row.Cells[1].Text:= 'Description';
    Row:= Tbl.AddRow;
    Row.Cells[0].ColSpan:= 2;          // merged cell across columns 0..1
    Row.Cells[0].Text:= 'merged header';
    Tbl.Render;
  finally
    Tbl.Free;
  end;
end;

THPDFTable

THPDFTable מחזיק בבעלותו את פריסת העמודות, את אוסף השורות ואת מעבר הרינדור; הוא מצייר דרך רכיב ה-THotPDF שמועבר אל THPDFTable.Create ומשתמש רק בחברים ציבוריים של THPDFPage ו-THotPDF

מתודות

מאפיינים

THPDFTableRow

THPDFTableRow מחזיק את התאים של שורת טבלה אחת וגם את דגלי רמת השורה שבהם נעשה שימוש בזמן מדידה ורינדור

THPDFTableCell

THPDFTableCell נושא את התוכן ואת דריסות הפר-תא שמוחלות מעל ברירות המחדל של הטבלה

enums של יישור

THPDFCellAlign = (caLeft, caCenter, caRight) בוחר את היישור האופקי של התא ו-THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) בוחר את היישור האנכי של התא

התנהגות פריסה ומעברי עמודים

גבהי השורות נמדדים מתוכן התאים תוך כיבוד גלישת שורות ו-THPDFTableRow.MinHeight, תאים מתפרשים מוצבים על רשת פנימית כך ש-THPDFTableCell.ColSpan ו-THPDFTableCell.RowSpan מתמזגים נכון בין שורות, ומעבר הרינדור עובר לעמוד חדש כשהשורה הבאה אינה נכנסת מעל THPDFTable.BottomMargin

כש-THPDFTable.RepeatHeader הוא true, רצועת הכותרת נפלטת מחדש בראש כל עמוד המשך לפני ששורות נוספות מצוירות

תאי תמונה שהוצגו ב-v2.432.0 מפנים לתמונה שרשומה דרך THotPDF.AddImage לפי אינדקס, מותאמים לרוחב התא, וגובהם נגזר מ-THPDFTableCell.ImageAspect כך שהתמונה שומרת על יחס התלתל המקורי שלה

ראו גם

• THotPDF Class
• THPDFPage Class
• THotPDF.AddImage Method
• Advanced text and streaming layout
• Typed table extraction