Método Application.CreateGroupLevel (Access)

Use o método CreateGroupLevel para especificar um campo ou expressão no qual agrupar ou classificar dados em um relatório.

Sintaxe

expressão. CreateGroupLevel (ReportName, Expression, Header, Footer)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
ReportName	Obrigatório	String	O nome do relatório que conterá o novo nível de grupo.
Expressão.	Obrigatório	String	O campo ou a expressão na qual é feita a classificação ou o agrupamento.
Header	Obrigatório	Integer	Indica que um campo ou expressão terá um cabeçalho de grupo associado. Se o argumento Cabeçalho for True (1), o campo ou expressão terá um cabeçalho de grupo. Se o argumento Cabeçalho for False (0), o campo ou a expressão não serão. Você pode criar um cabeçalho definindo o argumento como True.
Footer	Obrigatório	Integer	Indica que um campo ou expressão terá um rodapé de grupo associado. Se o argumento Footer for True (1), o campo ou expressão terá um rodapé de grupo. Se o argumento Footer for False (0), o campo ou a expressão não serão. Você pode criar um rodapé definindo o argumento como True.

Valor de retorno

Long

Comentários

Por exemplo, suponha que você estiver criando um assistente personalizado que fornece ao usuário com uma opção dos campos nos quais agrupar dados ao criar um relatório. Chame o método CreateGroupLevel no Assistente para criar os grupos apropriados de acordo com a opção do usuário.

Use o método CreateGroupLevel ao criar um assistente que cria um relatório com grupos ou totais. O método CreateGroupLevel agrupa ou classifica os dados do campo ou expressão especificada e cria um cabeçalho e/ou rodapé para o nível de grupo.

O método CreateGroupLevel está disponível somente no modo Design do relatório.

O Microsoft Access usa a matriz de propriedades GroupLevel para acompanhar os níveis de grupo criados para um relatório. O método CreateGroupLevel adiciona um novo nível de grupo à matriz baseado no argumento expression. O método CreateGroupLevel, em seguida, retorna um valor de índice que representa a posição do novo nível de grupo na matriz. O primeiro campo ou expressão em que você classifica ou agrupa é o nível 0, o segundo é o nível 1 e assim por diante. Você pode ter até 10 níveis de grupo em um relatório (de 0 a 9).

Quando você especifica que o argumento Cabeçalho ou Rodapé , ou ambos, é True, as propriedades GroupHeader e GroupFooter em um relatório são definidas como Sim, e um cabeçalho e/ou rodapé é criado para o nível de grupo.

Depois que um cabeçalho ou rodapé for criado, você poderá definir outras propriedades GroupLevel : GroupOn, GroupInterval e KeepTogether.

Observação

Se seu assistente criar níveis de grupo em um relatório novo ou existente, ele deverá abrir o relatório no modo de design.

Exemplo

O exemplo a seguir cria um nível de grupo em um campo OrderDate em um relatório chamado OrderReport. O relatório no qual o nível de grupo deve ser criada deve ser aberto no modo Design. Como os argumentos Cabeçalho e Rodapé são definidos como True (1), o método cria o cabeçalho e o rodapé para o nível de grupo. O cabeçalho e rodapé são então dimensionados.

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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.