4D v14.3

Subtotal

Página Inicial

 
4D v14.3
Subtotal

Subtotal 


 

Subtotal ( valores {; saltoPag} ) -> Resultado  
Parâmetro Tipo   Descrição
valores  Campo in Campo númerico ou variável onde quer devolver o subtotal
saltoPag  Inteiro longo in Nivel de quebra para o qual realizar um salto de página
Resultado   Real in Subtotal dos valores

Subtotal devolve o subtotal de valores para o nível de quebra atual ou anterior. Subtotal só funciona quando uma seleção ordenada é impressa com  PRINT SELECTION ou utilizando Imprimir no ambiente Desenho. O parâmetro valores deve ser de tipo real, inteiro, ou inteiro longo. Você deve atribuir o resultado da função Subtotal a uma variável localizada na área de quebra do formulário.

Advertência: deve executar os comandos BREAK LEVEL e ACCUMULATE antes de cada relatório de formulário para o qual queira fazer processo de quebra e calcular subtotais. Ver a discussão ao final da descrição deste comando.
O segundo parâmetro (opcional) da função Subtotal se utiliza para provocar saltos de página durante a impressão. Se saltoPag for 0, Subtotal não gera nenhum salto de página. Se saltoPag for igual a 1, Subtotal gera um salto de página para cada nível de quebra 1. Se saltoPag for igual a 2, Subtotal gera um salto de página para cada nível de quebra 1 e 2, etc.

Dica: se executa Subtotal desde um formulário de saída mostrado em tela, um erro será gerado, disparando um loop infinito de atualizações entre o formulário e a janela de erro. Para sair deste loop, pressione Alt+Shift (Windows) ou Opção-Shift (Macintosh) e clique no botão Abortar na janela de erro (provavelmente terá que fazer isto várias vezes). Isso pará temporariamente as atualizações da janela do formulário. Selecione outro formulário de saída de maneira a que o erro não se repita. Regresse ao ambiente Desenho e isole a chamada a Subtotal para um teste Form event=On Printing Break,  se deseja  utilizar o mesmo formulário de saída para a visualização e a impressão

Exemplo  

O exemplo a seguir é um método de objeto numa área de quebra de um formulário (B0, a área localizada sobre o marcador B0). A variável vSalario está localizada na área de quebra. A variável toma o valor do subtotal do campo Salário para este nível de quebra. O tratamento de quebra deve ter sido ativado de antemão utilizando os comandos BREAK LEVEL e ACCUMULATE.

 Case of
    :(Form event=On Printing Break)
       vSalario:=Subtotal([Empregados]Salario)
 End case

Para maior informação sobre design de formulário com áreas de cabeçalho e de quebra, consulte o manual de Desenho.

Para poder gerar relatórios com quebras, deve ativar o tratamento de quebras chamando os comandos BREAK LEVEL e ACCUMULATE.

Deve executar ambos comandos antes de imprimir um relatório de formulário. A função Subtotal é necessária para mostrar os valores em um formulário. Deve ordenar ao menos o número de níveis de quebras que necessite.

Quando utilize  BREAK LEVEL e ACCUMULATE, o processo de imprimir um relatório é geralmente como este:

1. Selecione os registros a imprimir.

2. Ordene os registros utilizando  ORDER BY. Ordene o mesmo número de níveis como quebras.

3. Executa BREAK LEVEL e ACCUMULATE.

4. Imprima o relatório utilizandoPRINT SELECTION.

A função Subtotal é necessária para mostrar valores em um formulário.

 
PROPRIEDADES 

Produto: 4D
Tema: Imprimir
Número 97

Este comando não pode ser utilizado com 4D Server

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

ACCUMULATE
BREAK LEVEL
Level (Nível de quebra)
PRINT SELECTION

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)