Méthode SortFields.Add2 (Excel)
Crée un champ de tri et retourne un objet SortFields qui peut éventuellement trier des types de données avec le sous-champ défini.
Syntaxe
expression. Add2 (Key, SortOn, Order, CustomOrder, DataOption, SubField)
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 | Variante | Indique si un ordre de tri personnalisé doit être utilisé. |
| DataOption | Facultatif | Variant | Valeur XlSortDataOption qui spécifie comment trier le texte. |
| subField | Facultatif | Variant | Spécifie le champ sur lequel effectuer le tri pour un type de données (tel que Population pour Geography ou Volume pour les stocks). |
Valeur renvoyée
SortField
Remarques
Cette API prend en charge le tri d’un sous-champ à partir de types de données, tels que Geography ou Stocks. Vous pouvez également utiliser la méthode Add si le tri par type de données n’est pas nécessaire.
Contrairement aux formules, les sous-champs ne nécessitent pas de crochets pour inclure des espaces.
Exemple
Cet exemple trie une table, Table1 sur Sheet1, par colonne1 dans l’ordre croissant en fonction des types de données SubField Population on Geography.
La méthode Clear est appelée avant pour s’assurer que le tri précédent est effacé afin qu’un nouveau tri 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.Add2 _
Key:=Range("Table1[[#All],[Column1]]"), _
SortOn:=xlSortOnValues, _
Order:=xlAscending, _
DataOption:=xlSortNormal, _
SubField:="Population"
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.