Koppelt een BIFF8-tabel (Excel ListObject) aan een celbereik en geeft het nieuwe
TXLSTable-object terug zodat aanvullende eigenschappen (
StyleName, rij-band-vlaggen,
TotalsRowShown) afgestemd kunnen worden vóór opslaan. De signatuur weerspiegelt
TXLSXWorkbook.AddTable aan de XLSX-kant zodat formaatongevoelige code dezelfde signatuur kan aanroepen. (Beschikbaar sinds v2.33.0.)
Syntaxis
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. De tabelnaam met gestructureerde verwijzing die in Excel's Name Box wordt weergegeven, bijvoorbeeld 'SalesTable'. Wordt zowel Name als DisplayName op het geretourneerde object |
| ARange |
WideString. Het celbereik dat de Table dekt in A1-notatie, bijvoorbeeld 'A1:D10'. De eerste rij van het bereik wordt behandeld als de koprij |
| AColumns |
TStrings. Koptekst per kolom. Moet precies evenveel items bevatten als het bereik breed is |
Opmerkingen
De nieuwe tabel wordt toegevoegd aan de
Tables-collectie van het werkblad. De
StyleName is standaard
'TableStyleMedium2' en
ShowRowStripes is standaard True, overeenkomend met wat Excel en de XLSX-kant produceren. De id (1..N per blad) wordt toegewezen bij opslaan als u deze niet instelt
BIFF8 genereert de FEATHEADR11 / FEAT11 / LIST12 recordgroep alleen bij SaveAs(xlExcel97). BIFF5-opslagen worden niet beïnvloed (tabellen zijn een BIFF8+-concept). Het LIST12-record slaat StyleName en de gebande rij-/kolomvlaggen op met behulp van de MS-XLS tabelstijl client-indeling
Voorbeeld
Dit voorbeeld schrijft een verkoopgebied van vier kolommen gebonden als een tabel op 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;
Zie ook