Méthode SortFields.Add (Excel)

Crée un champ de tri et renvoie un objet SortFields.

Syntaxe

expression. Ajouter (Key, SortOn, Order, CustomOrder, DataOption)

expression Variable qui représente un objet SortFields .

Paramètres

Nom Requis/Facultatif Type de données Description
Clé Obligatoire Range Spécifie une valeur de clé pour le tri.
SortOn Facultatif Variant Valeur XlSortOn qui spécifie la propriété d’une cellule à utiliser pour le tri.
Order Facultatif Variant Valeur XlSortOrder qui spécifie l’ordre de tri.
CustomOrder Facultatif Variant Indique si un ordre de tri personnalisé doit être utilisé.
DataOption Facultatif Variant Valeur XlSortDataOption qui spécifie comment trier le texte.

Valeur renvoyée

SortField

Remarques

Cette API n’inclut pas la prise en charge de types de données, tels que Géographie ou Actions. Pour définir un ordre de tri basé sur un sous-champ de l’un de ces types, reportez-vous à la méthode Add2 .

Exemple

Cet exemple trie un tableau, Table1 sur Feuil1, par Colonne1 dans l’ordre croissant.

La méthode Clear est appelée avant pour s’assurer que le tri précédent est effacé afin qu’un nouveau puisse être appliqué.

L’objet Sort est appelé pour appliquer le tri ajouté à Table1.

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal
With ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort
 .Header = xlYes
 .MatchCase = False
 .Orientation = xlTopToBottom
 .SortMethod = xlPinYin
 .Apply
End With

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.