מצמיד טבלת BIFF8 (Excel ListObject) לטווח תאים, ומחזיר את אובייקט ה-
TXLSTable החדש כדי שניתן יהיה לכוונן מאפיינים נוספים (
StyleName, דגלי שורות פסים,
TotalsRowShown) לפני שמירה. הצורה משקפת את
TXLSXWorksheet.AddTable בצד XLSX כדי שקוד אגנוסטי-לפורמט יוכל לקרוא לאותה חתימה. (זמין החל מגרסה v2.33.0.)
תחביר
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. The structured-reference table name shown in Excel's Name Box, e.g. 'SalesTable'. Becomes both Name and DisplayName on the returned אובייקט |
| ARange |
WideString. The תא טווח the Table covers in A1 notation, e.g. 'A1:D10'. The first שורה of the טווח is treated as the header שורה |
| AColumns |
TStrings. Header text per עמודה. Must contain exactly as many entries as the טווח is wide |
הערות
הטבלה החדשה נוספת לאוסף
Tables של גליון העבודה. ה-
StyleName שלה מוגדר כברירת מחדל ל-
'TableStyleMedium2' וה-
ShowRowStripes מוגדר כברירת מחדל ל-True, תואם למה ש-Excel ולצד XLSX מייצרים. ה-id (1..N לכל גיליון) מוקצה בזמן שמירה אם אינך מגדיר אותו
BIFF8 פולט את קבוצת הרשומות FEATHEADR11 / FEAT11 / LIST12 רק עם SaveAs(xlExcel97). שמירות BIFF5 אינן מושפעות (טבלאות הן מושג BIFF8+). רשומת LIST12 מאחסנת את StyleName ואת דגלי שורות/עמודות פסים תוך שימוש בפריסת סגנון טבלת MS-XLS ללקוח. מגרסה v2.33.2 הרשומות AUTOFILTERINFO / AUTOFILTER ברמת הגיליון מדוכאות כאשר טבלה על אותו גיליון מכסה לחלוטין את טווח ה-AutoFilter, מכיוון ש-Excel מטמיע את ה-AutoFilter בתוך אובייקט הטבלה עצמו; v2.87.4 גם כותב את מטה-נתוני ה-AutoFilter ברמת הטבלה וברמת השדה ל-FEAT11
דוגמה
דוגמה זו כותבת אזור מכירות בן ארבע עמודות הקשור כטבלה ב-A1:D10
var
cols: TStringList;
begin
cols := TStringList.Create;
try
cols.Add('Region');
cols.Add('Product');
cols.Add('Quarter');
cols.Add('Revenue');
Sheet.AddTable('SalesTable', 'A1:D10', cols);
finally
cols.Free;
end;
ראה גם