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-sidan så att formatagnostisk kod kan anropa samma signatur. (Tillgängligt sedan v2.33.0)
Syntax
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. Rubriktext per kolumn. Måste innehålla exakt lika många poster som området är brett |
Anmärkningar
The new table is added to the worksheet's
Tables collection. Its
StyleName defaults to
'TableStyleMedium2' and
ShowRowStripes har True som standard, vilket motsvarar det Excel och XLSX-sidan producerar. Id:t (1..N per blad) tilldelas vid sparningstillfället om du inte sätter det själv
BIFF8 emits the FEATHEADR11 / FEAT11 / LIST12 record group only on SaveAs(xlExcel97). BIFF5-sparningar påverkas inte (tabeller är ett BIFF8+-koncept). LIST12-posten lagrar StyleName och flaggorna för randiga rader / randiga kolumner med MS-XLS:s klientlayout för tabellstil. Från v2.33.2 anger kalkylbladets AUTOFILTERINFO / AUTOFILTER -poster undertrycks när en tabell på samma blad täcker autofilterområdet helt, eftersom Excel bäddar in autofiltret inuti tabellobjektet självt; v2.87.4 skriver även motsvarande AutoFilter-metadata på tabell- och fältnivå till FEAT11
Exempel
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 även