Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Utilize o método CreateGroupLevel para especificar um campo ou expressão no qual agrupar ou ordenar dados num 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 irá 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 Verdadeiro (1), o campo ou expressão terá um cabeçalho de grupo. Se o argumento Cabeçalho for Falso (0), o campo ou expressão nã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 Rodapé for Verdadeiro (1), o campo ou expressão terá um rodapé de grupo. Se o argumento Rodapé for Falso (0), o campo ou expressão nã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.
Utilize o método CreateGroupLevel ao conceber 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 utiliza a matriz de propriedades GroupLevel para controlar 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 ordena ou agrupa é o nível 0, o segundo é o nível 1 e assim sucessivamente. Você pode ter até 10 níveis de grupo em um relatório (de 0 a 9).
Quando especificar que o argumento Cabeçalho ou Rodapé , ou ambos, é Verdadeiro, as propriedades GroupHeader e GroupFooter num relatório são definidas como Sim e é criado um cabeçalho e/ou rodapé para o nível de grupo.
Depois de criar um cabeçalho ou rodapé, pode 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 seguinte cria um nível de grupo num campo OrderDate num relatório denominado OrderReport. O relatório no qual o nível de grupo deve ser criada deve ser aberto no modo Design. Uma vez que os argumentos Cabeçalho e Rodapé estão definidos como Verdadeiro (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.