Attache un tableau BIFF8 (ListObject Excel) à une plage de cellules, renvoyant le nouvel objet
TXLSTable pour régler des propriétés supplémentaires avant l'enregistrement. (Disponible depuis v2.33.0.)
Syntaxe
function AddTable(
const AName, ARange: WideString;
AColumns: TStrings):
TXLSTable;
| AName |
WideString. Nom de table à référence structurée affiché dans la Name Box d'Excel, par exemple 'SalesTable'. Devient à la fois Name et DisplayName sur l'objet renvoyé |
| ARange |
WideString. Plage de cellules couverte par la Table en notation A1, par exemple 'A1:D10'. La première ligne de la plage est traitée comme ligne d'en-tête |
| AColumns |
TStrings. Texte d'en-tête par colonne. Doit contenir exactement autant d'entrées que la plage est large |
Remarques
Le nouveau tableau est ajouté à la collection
Tables. Son
StyleName est défini sur
'TableStyleMedium2' et
ShowRowStripes sur True par défaut. L'id (1..N par feuille) est assigné à l'enregistrement si non défini
BIFF8 génère le groupe FEATHEADR11 / FEAT11 / LIST12 uniquement sur SaveAs(xlExcel97). Les enregistrements BIFF5 ne sont pas affectés. LIST12 stocke StyleName et les indicateurs de lignes/colonnes en alternance. Depuis v2.33.2, les enregistrements AUTOFILTERINFO/AUTOFILTER au niveau feuille sont supprimés lorsqu'un tableau couvre entièrement la plage de filtre automatique ; v2.87.4 écrit également les métadonnées AutoFilter dans FEAT11
Exemple
Cet exemple écrit une région de ventes à quatre colonnes liée comme tableau en 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;
Voir aussi