Attaches a BIFF8 Table (Excel ListObject) to a cell range, returning the new
TXLSTable object so additional properties (
StyleName, banded-row flags,
TotalsRowShown) can be tuned before save. The shape mirrors
TXLSXWorksheet.AddTable XLSX tarafında da mevcut; böylece biçimden bağımsız kod aynı imzayı çağırabilir. (v2.33.0'dan beri mevcut)
Sözdizimi
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 object |
| ARange |
WideString. The cell range the Table covers in A1 notation, e.g. 'A1:D10'. The first row of the range is treated as the header row |
| AColumns |
TStrings. Sütun başına başlık metni. Aralığın genişliği kadar tam sayıda girdi içermelidir |
Açıklamalar
The new table is added to the worksheet's
Tables collection. Its
StyleName defaults to
'TableStyleMedium2' and
ShowRowStripes varsayılan olarak True'dur; Excel'in ve XLSX tarafının ürettiğiyle eşleşir. Kimlik (sayfa başına 1..N), siz atamazsanız kaydetme sırasında atanır
BIFF8 emits the FEATHEADR11 / FEAT11 / LIST12 record group only on SaveAs(xlExcel97). BIFF5 kayıtları etkilenmez (Tables bir BIFF8+ kavramıdır). LIST12 kaydı StyleName ve bantlı satır / bantlı sütun bayrakları MS-XLS tablo stili istemci düzenini kullanır. v2.33.2'den itibaren sayfa düzeyindeki AUTOFILTERINFO / AUTOFILTER kayıtları, aynı sayfadaki bir Table autofilter aralığını tamamen kapsıyorsa bastırılır; çünkü Excel autofilter'ı Table nesnesinin içine gömer. v2.87.4 ayrıca karşılık gelen tablo düzeyi ve alan düzeyi AutoFilter meta verisini FEAT11'e yazar
Örnek
This example writes a four-column sales region bound as a Table at 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;
Ayrıca bkz.