Menempelkan Table BIFF8 (Excel ListObject) ke rentang sel, lalu mengembalikan objek
TXLSTable baru sehingga properti tambahan (
StyleName, flag baris berpita,
TotalsRowShown) dapat disetel sebelum save. Bentuknya mencerminkan
TXLSXWorksheet.AddTable di sisi XLSX sehingga kode yang format-agnostik dapat memanggil signature yang sama. (Tersedia sejak v2.33.0.)
Sintaks
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. Nama tabel structured-reference yang ditampilkan di Name Box Excel, misalnya 'SalesTable'. Menjadi Name dan DisplayName pada objek yang dikembalikan |
| ARange |
WideString. Range sel yang dicakup Table dalam notasi A1, misalnya 'A1:D10'. Baris pertama range diperlakukan sebagai header |
| AColumns |
TStrings. Teks header per kolom. Harus berisi jumlah entri yang sama dengan lebar range |
Remarks
Tabel baru ditambahkan ke koleksi
Tables worksheet.
StyleName-nya default ke
'TableStyleMedium2' dan
ShowRowStripes default ke True, sesuai dengan yang dihasilkan Excel dan sisi XLSX. Id (1..N per sheet) ditetapkan saat save jika Anda tidak mengaturnya
BIFF8 mengeluarkan grup record FEATHEADR11 / FEAT11 / LIST12 hanya pada SaveAs(xlExcel97). Penyimpanan BIFF5 tidak terpengaruh (Tables adalah konsep BIFF8+). Record LIST12 menyimpan StyleName dan flag baris/kolom berpita memakai tata letak client style tabel MS-XLS. Sejak v2.33.2 record AUTOFILTERINFO / AUTOFILTER tingkat sheet ditekan saat Table pada sheet yang sama sepenuhnya menutup rentang autofilter, karena Excel menyematkan autofilter di dalam objek Table itu sendiri; v2.87.4 juga menulis metadata AutoFilter tingkat tabel dan tingkat field yang sesuai ke FEAT11
Contoh
Contoh ini menulis wilayah penjualan empat kolom sebagai Table di 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;
Lihat juga