Compartilhar via


Propriedade GroupLevel.GroupOn (Access)

Utilize a propriedade GroupOn num relatório para especificar como agrupar dados num campo ou expressão por tipo de dados. Por exemplo, esta propriedade permite-lhe agrupar um campo Data 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 definiçõ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
Intervalo Valores dentro de um intervalo que especificar. 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 seguinte define as propriedades SortOrder e agrupamento para o primeiro nível de grupo no relatório Produtos Por Categoria 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.