Acumulador de uma quebra, seção e relatório que utiliza a classe TReport.
Um Acumulador pode executar uma das seguintes funções abaixo, utilizando como referência uma célula da seção ou o retorno de uma fórmula definida para ele:
SUM - Somar
COUNT - Contar
MAX - Valor máximo
MIN - Valor mínimo
AVERAGE - Valor médio
ONPRINT - Valor atual
TIMESUM - Somar horas
TIMEAVERAGE - Valor medio de horas
TIMESUB - Subtrai horas
Na criação do acumulador sempre é informado uma seção (TRSection) a qual ele pertence, e automaticamente o acumulador será incluído no relatório (TReport) que a seção pertence.
Esta classe herda as propriedades e métodos da classe TRFUNCTION
Métodos:
| Painel |
|---|
ColSintaxe
TRCollection():Col( ) →
Descrição
Compatibilidade – Não utilizado |
| Painel |
|---|
EvalFunction
Sintaxe
TRCollection():EvalFunction( ) →
Descrição
Atualiza o conteúdo dos acumuladores |
| Painel |
|---|
New
Sintaxe
TRCollection():New( <cName> , <cFunction> , <oBreak> , <uTitle> , <cPicture> , <uFormula> , <lEndSection> , <lEndReport> , <oParent> , <bCondition> , <uContent> ) →
Descrição
Método construtor da classe TRCollection
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| cName | Caracter | Identificação do acumulador |
| | cFunction | Caracter | Função que será utilizada pelo acumulador. Exemplo: SUM, COUNT, MAX, MIN |
| | oBreak | Objeto | Objeto da classe TRBreak que define em qual quebra o acumulador será impresso |
| | uTitle | Caracter / Bloco de Código | Título do acumulador. Texto a ser impresso no formato caracter ou bloco de código |
| | cPicture | Caracter | Máscara de impressão do acumulador |
| | uFormula | Caracter / Bloco de Código | Regra para acúmulo dos valores
Tipo Caracter: Expressão ADVPL para macro execução
Tipo Bloco de Código: Bloco de Código com a expressão ADVPL para execução |
| | lEndSection | Lógico | Se verdadeiro, indica se o acumulador será impresso na quebra de seção |
| | lEndReport | Lógico | Se verdadeiro, indica se o acumulador será impresso no final do relatório |
| | oParent | Objeto | Objeto da classe TRSection que o acumulador se refere |
| | bCondition | Bloco de Código | Bloco de Código com a condição de atualização dos valores do acumulador |
| | uContent | Caracter / Bloco de Código | Regra com o valor acumulado
Tipo Caracter: Expressão ADVPL para macro execução
Tipo Bloco de Código: Bloco de Código com a expressão ADVPL para execução |
|
Retorno
Objeto da classe TRCollection
|
| Painel |
|---|
ResetSintaxe
TRCollection():Reset( ) →
Descrição
Inicializa o acumulador atual |
| Painel |
|---|
ResetPage
Sintaxe
TRCollection():ResetPage( ) →
Descrição
Inicializa o acumulador da página |
| Painel |
|---|
ResetReportSintaxe
TRCollection():ResetReport( ) →
Descrição
Inicializa o acumulador do relatório |
| Painel |
|---|
ResetSection
Sintaxe
TRCollection():ResetSection( ) →
Descrição
Inicializa o acumulador da seção |
| Painel |
|---|
ResetSize
Sintaxe
TRCollection():ResetSize( <nType> ) →
Descrição
Inicializa o tamanho da célula de impressão do acumulador
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
nType
| Numérico | Aponta o tipo de collection a ser verificado
0 – Acumulador atual
1 – Acumulador do relatório
2 – Acumulador da seção
3 – Acumulador da página |
|
Retorno
Objeto da classe TRCollection
|
| Painel |
|---|
SetBreakSintaxe
TRCollection():SetBreak( <oBreak> ) →
Descrição
Define a quebra (TRBreak) que o acumulador será impresso
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| oBreak | Objeto | Objeto da classe TRBreak |
|
|
| Painel |
|---|
SetPicture
Sintaxe
TRCollection():SetPicture( <cPicture> ) →
Descrição
Define a máscara de impressão do acumulador
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| cPicture | Caracter | Máscara do acumulador |
|
|
| Painel |
|---|
SetTitleSintaxe
TRCollection():SetTitle( <uTitle> ) →
Descrição
Define o título que será impresso antes da impressão dos acumuladores
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| uTitle | Caracter / Bloco de Código | Texto a ser impresso no formato caracter ou bloco de código |
|
|
| Painel |
|---|
SetTotalInLine
Sintaxe
TRCollection():SetTotalInLine( <lTotalInLine> ) →
Descrição
Define que o acumulador será impresso em linhas
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| lTotalInLine | Lógico | Se verdadeiro, aponta que o acumulador será impresso em linhas |
|
|
| Painel |
|---|
TitleSintaxe
TRCollection():Title( ) →
Descrição
Retorna o título do acumulador
Retorno
Título do acumulador |
| Painel |
|---|
XmlLoadSintaxe
TRCollection():XmlLoad( <oXml> ) →
Descrição
Carrega um acumulador do tipo collection do layout personalizado pelo usuário
Parâmetros | Nome | Tipo | Descrição | Obrigatório |
|---|
| oXml | Objeto | Objeto do tipo XML com as personalizações do acumulador |
|
|
| Painel |
|---|
XmlSave
Sintaxe
TRCollection():XmlSave( ) →
Descrição
Salva o acumulador do tipo collection no layout personalizado pelo usuário |
