Knytter en BIFF8-tabel (Excel ListObject) til et celleområde og returnerer det nye
TXLSTable-objekt, så yderligere egenskaber (
StyleName, stribede rækkeflag,
TotalsRowShown) kan finjusteres inden gemning. Formen spejler
TXLSXWorksheet.AddTable på XLSX-siden, så formatuafhængig kode kan kalde den samme signatur. (Tilgængelig siden v2.33.0.)
Syntaks
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. Navnet på den strukturerede referencetabel, som vises i Excels Navnefelt, f.eks. 'SalesTable'. Bliver til både Name og DisplayName på det returnerede objekt |
| ARange |
WideString. Celleområdet som tabellen dækker i A1-notation, f.eks. 'A1:D10'. Områdets første række behandles som overskriftsrække |
| AColumns |
TStrings. Overskriftstekst pr. kolonne. Skal indeholde præcis lige så mange poster, som området er bredt |
Bemærkninger
Den nye tabel tilføjes til regnearksets
Tables-samling. Dens
StyleName er som standard
'TableStyleMedium2' og
ShowRowStripes er som standard True, hvilket svarer til hvad Excel og XLSX-siden producerer. Id'et (1..N pr. ark) tildeles ved gemning, hvis du ikke angiver det
BIFF8 udsender FEATHEADR11 / FEAT11 / LIST12-postgruppen kun ved SaveAs(xlExcel97). BIFF5-gemninger er upåvirket (tabeller er et BIFF8+-koncept). LIST12-posten gemmer StyleName og stribede-rækker/-kolonner-flagene ved hjælp af MS-XLS-tabellayout. Fra v2.33.2 undertrykkes AUTOFILTERINFO/AUTOFILTER-poster på arkniveau, når en tabel på det samme ark fuldt ud dækker autofilterområdet, fordi Excel indlejrer autofilteret i selve tabelobjektet; v2.87.4 skriver også de tilsvarende tabel- og felt-niveau AutoFilter-metadata til FEAT11
Eksempel
Dette eksempel skriver en fire-kolonne salgsregion bundet som en tabel på 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å