Pripne BIFF8 tabelo (Excel ListObject) na obseg celic in vrne nov objekt
TXLSTable, da je mogoče dodelati dodatne lastnosti (
StyleName, zastavice pasovnih vrstic,
TotalsRowShown) pred shranjevanjem. Oblika zrcali
TXLSXWorksheet.AddTable na strani XLSX, tako da koda, neodvisna od formata, lahko pokliče enak podpis. (Na voljo od v2.33.0.)
Sintaksa
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. Ime tabele s strukturiranim sklicem, prikazano v Excelovem polju Name Box, npr. 'SalesTable'. Na vrnjenem objektu postane tako Name kot DisplayName |
| ARange |
WideString. Obseg celic, ki ga Table pokriva v zapisu A1, npr. 'A1:D10'. Prva vrstica obsega se obravnava kot vrstica glave |
| AColumns |
TStrings. Besedilo glave za vsak stolpec. Vsebovati mora natanko toliko vnosov, kolikor je obseg širok |
Opombe
Nova tabela je dodana v zbirko
Tables delovnega lista. Privzeti
StyleName je
'TableStyleMedium2',
ShowRowStripes pa je privzeto True, kar ustreza temu, kar ustvari Excel in stran XLSX. ID (1..N na list) je dodeljen ob shranjevanju, če ga ne nastavite
BIFF8 oddaja skupino zapisov FEATHEADR11 / FEAT11 / LIST12 samo pri SaveAs(xlExcel97). Shranjevanja BIFF5 niso prizadeta (Tabele so koncept BIFF8+). Zapis LIST12 shrani StyleName in zastavice pasovnih vrstic/stolpcev z uporabo postavitve odjemalca tabele MS-XLS. Od v2.33.2 se zapisi AUTOFILTERINFO / AUTOFILTER na ravni lista zatrejo, ko Tabela na istem listu v celoti pokriva območje samodejnega filtra, ker Excel vgradi samodejni filter v sam objekt Tabele; v2.87.4 prav tako zapiše ustrezne metapodatke AutoFilter na ravni tabele in polj v FEAT11
Primer
Ta primer zapiše prodajno regijo s štirimi stolpci, vezano kot Tabela pri 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;
Glejte tudi