Application.CreateGroupLevel, méthode (Access)

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

Syntaxe

expression. CreateGroupLevel (nom_rapport, expression, en-tête, pied de page)

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 en-tête de groupe est associé à un champ ou une expression. Si l’argument d’en-tête est vrai (1), le champ ou l’expression aura un en-tête de groupe. Si l’argument d’en-tête est Faux (0), le champ ou l’expression ne sera pas le cas. 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 est Vrai (1), le champ ou l’expression aura un pied de groupe. Si l’argument Pied de page est Faux (0), le champ ou l’expression ne le sera pas. 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 état 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 que vous triez ou regroupez dépend du niveau 0, le second du niveau 1, etc. Vous pouvez avoir jusqu'à 10 niveaux de regroupement dans un rapport (0 à 9).

Lorsque vous spécifiez que l’argument En-tête ou Pied de page , ou les deux, est Vrai, les propriétés En-tête de groupe et Pied de groupe d’un état 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 avoir créé un en-tête ou 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 DateCommande d’un état intitulé RapportCommande. 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 au 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.