Saltar para o conteúdo principal
Versão: Próximo

BREAK LEVEL

BREAK LEVEL ( nivel {; saltoPagina} )

ParâmetroTipoDescrição
nivelInteiro longo🡒Número de níveis de quebra
saltoPaginaInteiro longo🡒Nível de quebra para o qual fazer um salto de página.

Descrição

BREAK LEVEL especifica o número de níveis de quebra em um relatório realizado utilizando PRINT SELECTION.

Deve executar BREAK LEVEL e ACCUMULATE antes de cada relatório no qual queira utilizar quebras. Estes comandos ativam o processo de quebras para um relatório. Ver a explicação para o comando Subtotal.

O parâmetro nivel indica o último nível de quebra para o qual queira realizar processos de quebras. Deve ter ordenado os registros com ao menos esse número de níveis. Se tiver ordenado mais níveis, estes níveis serão impressos como estão ordenados, mas não serão processados para quebras.

Cada nível de quebra gerado imprimirá as áreas de quebras e de cabeçalho correspondentes no formulário. Deve ter no formulário ao menos tantas áreas de quebra como o número que passou em nivel. Se houver mais áreas de quebra, serão ignoradas e não serão impressas.

O segundo parâmetro, opcional, saltoPagina, se utiliza para provocar saltos de página durante a impressão.

Exemplo

O exemplo a seguir imprime um relatório com dois níveis de quebra. A seleção é ordenada em quatro níveis, mas o comando BREAK LEVEL especifica apenas dois níveis de quebra. Um campo se acumula com o comando ACCUMULATE :

 ORDER BY([Emp]Departamento;>;[Emp]Titulo;>;[Emp]Sobrenome;>;[Emp]Nome;>) // Ordenar em quatro campos
 BREAK LEVEL(2) // Fixar 2 níveis de quebra (Departamento e título)
 ACCUMULATE([Emp]Salario) // Acumular os salários
 FORM SET OUTPUT([Emp];"Departamento recursos humanos") // Selecionar o formulário a imprimir
 PRINT SELECTION([Emp]) // Imprimir o relatório

Ver também

ACCUMULATE
ORDER BY
PRINT SELECTION
Subtotal