Méthode Application.CreateGroupLevel (Access)

Utilisez la méthode CreateGroupLevel pour spécifier un champ ou une expression sur lequel regrouper ou trier des données dans un rapport.

Syntaxe

expression. CreateGroupLevel (ReportName, Expression, Header, Footer)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
ReportName	Obligatoire	String	Nom du rapport qui contiendra le nouveau niveau de groupe.
Expression	Obligatoire	String	Champ ou expression de tri ou de groupement.
Header	Obligatoire	Integer	Indique qu’un champ ou une expression aura un en-tête de groupe associé. Si l’argument Header a la valeur True (1), le champ ou l’expression aura un en-tête de groupe. Si l’argument Header a la valeur False (0), ce n’est pas le cas du champ ou de l’expression. Vous pouvez créer un en-tête en définissant l'argument sur True.
Footer	Obligatoire	Integer	Indique si qu'un champ ou une expression auront un pied de groupe associé. Si l’argument Pied de page a la valeur True (1), le champ ou l’expression aura un pied de page de groupe. Si l’argument Pied de page a la valeur False (0), ce n’est pas le cas du champ ou de l’expression. Vous pouvez créer un pied de page en définissant l'argument sur True.

Valeur renvoyée

Entier long

Remarques

Par exemple, supposons que vous créez un Assistant personnalisé qui permet à l'utilisateur avec un choix de champs sur lesquels regrouper des données lors de la conception d'un état. Appelez la méthode CreateGroupLevel à partir de l'Assistant pour créer les groupes appropriés en fonction des choix de l'utilisateur.

Utilisez la méthode CreateGroupLevel lors de la conception d’un Assistant qui crée un rapport avec des groupes ou des totaux. La méthode CreateGroupLevel regroupe ou trie les données dans le champ spécifié ou l'expression et crée un en-tête et/ou un pied de page pour le niveau de groupe.

La méthode CreateGroupLevel n'est disponible qu'en mode Création d'état.

Microsoft Access utilise le tableau de propriétés GroupLevel pour effectuer le suivi des niveaux de groupe créés pour un rapport. La méthode CreateGroupLevel ajoute un nouveau niveau de groupe dans le tableau, en fonction de l'argument expression. La méthode CreateGroupLevel renvoie ensuite une valeur d'index qui représente la position du nouveau niveau groupe dans le tableau. Le premier champ ou expression sur lequel vous triez ou regroupez est le niveau 0, le second est le niveau 1, et ainsi de suite. Vous pouvez avoir jusqu'à 10 niveaux de regroupement dans un rapport (0 à 9).

Lorsque vous spécifiez que l’argument Header ou Footer , ou les deux, a la valeur True, les propriétés GroupHeader et GroupFooter dans un rapport sont définies sur Oui, et un en-tête et/ou un pied de page sont créés pour le niveau du groupe.

Après la création d’un en-tête ou d’un pied de page, vous pouvez définir d’autres propriétés GroupLevel : GroupOn, GroupInterval et KeepTogether.

Remarque

Si votre Assistant est destiné à créer des niveaux de groupe dans un nouvel état ou dans un état existant, il doit d'abord ouvrir l'état en mode Création.

Exemple

L’exemple suivant crée un niveau de groupe sur un champ OrderDate sur un rapport appelé OrderReport. Le rapport sur lequel le niveau de groupe doit être créée doit être ouvert en mode Création. Étant donné que les arguments En-tête et Pied de page sont définis sur True (1), la méthode crée à la fois l’en-tête et le pied de page pour le niveau du groupe. L'en-tête et le pied de page sont ensuite redimensionnés.

Sub CreateGL() 
 Dim varGroupLevel As Variant 
 
 ' Create new group level on OrderDate field. 
 varGroupLevel = CreateGroupLevel("OrderReport", "OrderDate", _ 
 True, True) 
 ' Set height of header/footer sections. 
 Reports!OrderReport.Section(acGroupLevel1Header).Height = 400 
 Reports!OrderReport.Section(acGroupLevel1Footer).Height = 400 
End Sub

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.