HotXLS ドキュメント

AddTable メソッド

セル範囲に BIFF8 テーブル (Excel ListObject) を関連付け、新しい TXLSTable オブジェクトを返します。保存前に追加プロパティ(StyleName、縞模様フラグ、TotalsRowShown)を調整できます。この形式は XLSX 側の TXLSXWorksheet.AddTable と対応しています(v2.33.0 以降)

構文

function AddTable(const AName, ARange: WideString; AColumns: TStrings): TXLSTable;
AName WideString Excel の Name Box に表示される structured-reference の table name 例 'SalesTable' 返される object では Name と DisplayName の両方になる
ARange WideString Table が A1 表記でカバーする cell range 例 'A1:D10' range の最初の row は header row とみなされる
AColumns TStrings 列ごとのヘッダー テキスト 範囲の幅と同じ数の項目をちょうど含める必要がある

備考

BIFF8 は SaveAs(xlExcel97) でのみ FEATHEADR11 / FEAT11 / LIST12 レコードグループを出力します。BIFF5 保存には影響しません(テーブルは BIFF8+ の概念です)

この例では、4 列の売上地域データを 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;

関連項目