Dokumentace HotXLS

Metoda AddTable

Připojí tabulku BIFF8 (Excel ListObject) k rozsahu buněk a vrátí nový objekt TXLSTable pro další konfiguraci

Syntaxe

function AddTable(const AName, ARange: WideString; AColumns: TStrings): TXLSTable;
AName WideString. Název tabulky se strukturovaným odkazem zobrazený v poli názvu v Excelu, např. 'SalesTable'. Na vráceném objektu se stane zároveň Name i DisplayName
ARange WideString. Rozsah buněk, který tabulka pokrývá, v zápisu A1, např. 'A1:D10'. První řádek rozsahu se považuje za záhlaví
AColumns TStrings. Text záhlaví pro každý sloupec. Musí obsahovat právě tolik položek, kolik má rozsah sloupců

Poznámky

Nová tabulka je přidána do kolekce Tables listu. Výchozí hodnota StyleName je prázdný řetězec

BIFF8 emituje skupinu záznamů FEATHEADR11 / FEAT11 / LIST12 pouze při SaveAs(xlExcel97). Ukládání BIFF5 není ovlivněno (Tabulky jsou funkce BIFF8+)

Příklad

Tento příklad zapíše čtyřsloupcový prodejní region vázaný jako Tabulka na 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;

Viz také