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 på XLSX-siden, så formatagnostisk kode kan kalde den samme signatur. (Tilgængelig siden v2.33.0.)
Syntaks
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. Overskriftstekst pr. kolonne. Skal indeholde nøjagtigt lige så mange poster, som området er bredt |
Bemærkninger
The new table is added to the worksheet's
Tables collection. Its
StyleName defaults to
'TableStyleMedium2' and
ShowRowStripes har som standard True, svarende til det, Excel og XLSX-siden producerer. Id'et (1..N pr. ark) tildeles ved gemning, hvis du ikke sætter det
BIFF8 emits the FEATHEADR11 / FEAT11 / LIST12 record group only on SaveAs(xlExcel97). BIFF5-gemninger påvirkes ikke (tabeller er et BIFF8+-koncept). LIST12-recorden gemmer StyleName og flagene for skiftende rækker/kolonner via MS-XLS-tabellens typografi-client-layout. Fra v2.33.2 bruger arkniveauets AUTOFILTERINFO / AUTOFILTER -records udelades, når en tabel på samme ark fuldt dækker autofilter-området, fordi Excel indlejrer autofilteret i tabelobjektet selv; v2.87.4 skriver også de tilsvarende AutoFilter-metadata på tabel- og feltniveau ind i FEAT11
Eksempel
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;
Se også