Propriedade GroupLevel.GroupOn (Access)

Use a propriedade GroupOn em um relatório para especificar como agrupar dados em um campo ou expressão por tipo de dados. Por exemplo, essa propriedade permite agrupar um campo Date por mês. número inteiro de leitura/gravação.

Sintaxe

expressão. Groupon

Expressão Uma variável que representa um objeto GroupLevel .

Comentários

As configurações da propriedade GroupOn disponíveis para um campo dependem de seu tipo de dados, como mostra a tabela a seguir. Para uma expressão, todas as configurações estão disponíveis. A configuração padrão de todos os tipos de dados é Cada valor.

Tipo de dados de campo	Configuração	Agrupa registros com	Visual Basic
Texto	(Padrão) Cada valor	O mesmo valor no campo ou na expressão.	0
	Caracteres de prefixo	O mesmo número n de primeiros caracteres no campo ou na expressão.	1
Data/Hora	(Padrão) Cada valor	O mesmo valor no campo ou na expressão.	0
	Ano	Datas no mesmo ano civil.	2
	Tri	Datas no mesmo trimestre.	3
	Mês	Datas no mesmo mês.	4
	Semana	Datas na mesma semana.	5
	Dia	Datas no mesmo dia.	6
	Hora	Horários de mesma hora.	7
	Minuto	Horários de mesmo minuto.	8
Numeração Automática, Moeda, Número	(Padrão) Cada valor	O mesmo valor no campo ou na expressão.	0
	Interval	Valores dentro de um intervalo que você especifica.	9

No Visual Basic, você define essa propriedade no procedimento de evento Open de um relatório.

Para definir a propriedade GroupOn como um valor diferente de cada valor, você deve primeiro definir a propriedade GroupHeader ou GroupFooter, ou ambas, como Sim para o campo ou expressão selecionada.

Exemplo

O exemplo a seguir define as propriedades SortOrder e grouping para o primeiro nível de grupo no relatório Products By Category para criar uma lista alfabética de produtos.

Private Sub Report_Open(Cancel As Integer) 
    ' Set SortOrder property to ascending order. 
    Me.GroupLevel(0).SortOrder = False 
    ' Set GroupOn property. 
    Me.GroupLevel(0).GroupOn = 1 
    ' Set GroupInterval property to 1. 
    Me.GroupLevel(0).GroupInterval = 1 
    ' Set KeepTogether property to With First Detail. 
    Me.GroupLevel(0).KeepTogether = 2 
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.