Histórico da Página

...

Obs.: Uma seção (TRSection) pode ser considerada um tópico dentro do relatório, podendo ter um ou mais tópicos que se relacionam no relatório.

Informações

title	Importante

A partir da Lib 20230220, a opção de impressão de planilha em formato xlsx passa gerar os dados de processamento no Banco de Dados ao invés de utilizar a memória do sistema, esta alteração visa solucionar problemas com alto consumo de memória.

Métodos:

Painel

AddBreak

Sintaxe
TReport():AddBreak( <oBreak> ) → NIL

Descrição
Adiciona a quebra de impressão na propriedade aBreak

Parâmetros

Nome	Tipo	Descrição	Obrigatório
oBreak	Objeto	Objeto TRBreak	X

...

Painel

GetParam

Sintaxe
TReport():GetParam( ) →

Descrição
Retorna a pergunta ou bloco de código utilizado como parâmetros do relatório

Painel

GetWidth

GetRightAlignPrinter

Sintaxe
TReport():GetWidthGetRightAlignPrinter( ) → → lAlignPrinter

Descrição
Retorna a largura da páginase o alinhamento do relatório para células à direita está utilizando o componente do binário.

Retorno

lAlignPrinter

Aviso
Método disponível a partir da LIB Label 20211004

Painel

GetWidth

Sintaxe
TReport():GetWidth( ) →

Descrição
Retorna a largura da página

Painel

HideFooter

Sintaxe
TReport(

Painel

HideFooter

Sintaxe
TReport():HideFooter( ) →

Descrição
Define que não será impresso o rodapé padrão da página

...

Layout a ser carregado

Painel
LoadDefault Sintaxe TReport():LoadDefault( ) → Descrição Carrega o relatório padrão para personalização
Painel
LoadLayout Sintaxe TReport():LoadLayout( <cLayout> ) → Descrição Carrega um layout customizado para impressão Parâmetros
Nome	Tipo	Descrição	Obrigatório
cLayout	Caracter	X

Painel

New

Sintaxe
TReport():New( <cReport> , <cTitle> , <uParam> , <bAction> , <cDescription> , <lLandscape> , <uTotalText> , <lTotalInLine> , <cPageTText> , <lPageTInLine> , <lTPageBreak> , <nColSpace> ) → oRet

Descrição
Método construtor da classe TReport

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cReport	Caracter	Nome do relatório. Exemplo: MATR010	X
cTitle	Caracter	Título do relatório
uParam	Caracter / Bloco de Código	Parâmetros do relatório cadastrado no Dicionário de Perguntas (SX1). Também pode ser utilizado bloco de código para parâmetros customizados
bAction	Bloco de Código	Bloco de código que será executado quando o usuário confirmar a impressão do relatório
cDescription	Caracter	Descrição do relatório
lLandscape	Lógico	Aponta a orientação de página do relatório como paisagem
uTotalText	Caracter / Bloco de Código	Texto do totalizador do relatório, podendo ser caracter ou bloco de código
lTotalInLine	Lógico	Imprime as células em linha
cPageTText	Caracter	Texto do totalizador da página
lPageTInLine	Lógico	Imprime totalizador da página em linha
lTPageBreak	Lógico	Quebra página após a impressão do totalizador
nColSpace	Numérico	Espaçamento entre as colunas

Retorno
oRet - Objeto da classe TReport

...

Painel

PageTotalInLine

Sintaxe
TReport():PageTotalInLine( <lTotalInLine> ) →

Descrição
Define se o total da página será impresso em linha ou coluna

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lTotalInLine	Lógico	Se verdadeirofalso, será impresso em linha

Painel

PageTotalText

Sintaxe
TReport():PageTotalText( <cText> ) →

Descrição
Define o texto do totalizador da página

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cText	Caracter	Texto do totalizador da página

...

Painel

PrintGraphic

Sintaxe
TReport():PrintGraphic( ) →

Descrição
Imprime os gráficos do relatório de acordo com o componente TRCollection.

Painel

PrintHeader

Sintaxe
TReport():PrintHeader( <lHeaderSection> ,<lPage> ) →

Descrição
Imprime o cabeçalho padrão do relatório

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lHeaderSection	Lógico	Imprime cabeçalho da seção
lPage	Lógico	Imprime Informações sobre a página, como por exemplo, número da página

...

Painel

SetDevice

Sintaxe
TReport():SetDevice( <nDevice> ) →

Descrição
Define o tipo de impressão selecionado. Opções: 1-Arquivo,2-Impressora,3-Email,4-Planilha e , 5-Html e 6-PDF

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nDevice	Numérico	Tipo de impressão selecionada	X

...

Painel

SetPxLeftMargin

Sintaxe
TReport():SetPxLeftMargin( <nPxLeftMargin> ) →

Descrição
Define a margem à esquerda em pixel do relatório

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nPxLeftMargin	Numérico	Tamanho da margem à esquerda em pixel	X

panel

Painel

SetRow

SetRightAlignPrinter

Sintaxe
TReport():SetRowSetRightAlignPrinter( <nRow> <lAlignPrinter> ) →

Descrição
Define a margem à esquerda em pixel do relatórioSeta que será utilizado o componente do binário para realizar o alinhamento das células que estejam à direita.

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nRowlAlignPrinter	Numérico	Lógico	Se verdadeiro, utiliza o alinhamento do binário para células à direitaNúmero da linha a ser impressa	X

Informações

SetStartPage

title

Sintaxe
TReport():SetStartPage( <lStartPage> ) →
Descrição
Define que deverá ser gerada uma nova página no relatório
Parâmetros

Nome

Tipo

Descrição

Obrigatório

lStartPage

Lógico

Se verdadeiro, aponta a necessidade de uma nova página

Importante

Ao utilizar esse método ficar atento ao alinhamento das células, as mesmas deverão estar alinhadas à direita (sem espaços à esquerda) para que fique com o comportamento correto.

Aviso
Método disponível a partir da LIB Label 20211004

Painel

SetRow

Painel

SetTitle

Sintaxe
TReport():SetTitleSetRow( <cTitle> <nRow> ) →

Descrição
Define o título a margem à esquerda em pixel do relatório

Parâmetros
Nome Tipo Descrição Obrigatório
cTitlenRow Lógico Numérico Número da linha a ser impressaTítulo do relatório X

Painel

SetTotalInLine

SetStartPage

Sintaxe
TReport():SetTotalInLineSetStartPage( <lTotalInLine> <lStartPage> ) →

Descrição
Define se os totalizadores serão impressos em linha ou colunaque deverá ser gerada uma nova página no relatório

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lTotalInLinelStartPage	Lógico	Se verdadeiro, imprime em linhaaponta a necessidade de uma nova página

Painel

SetTotalPageBreak

SetTitle

Sintaxe
TReport():SetTotalPageBreakSetTitle( <lTPageBreak> <cTitle> ) →

Descrição
Define que será quebrada página após a impressão do totalizadoro título do relatório

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lTPageBreakcTitle	LógicoSe verdadeiro, aponta a quebra de página após a impressão do totalizador	Título do relatório	X

Painel

SetTotalText

SetTotalInLine

Sintaxe
TReport():SetTotalTextSetTotalInLine( <uText> <lTotalInLine> ) →

Descrição
Define o texto que será impresso antes da impressão dos totalizadoresse os totalizadores serão impressos em linha ou coluna

Parâmetros

Nome	Tipo	Descrição	Obrigatório
uTextlTotalInLine	LógicoTexto a ser impresso no formato caracter ou bloco de código	Se falso, imprime em linha

Painel

ShowFooter

SetTotalPageBreak

Sintaxe
TReport():ShowFooterSetTotalPageBreak( <lTPageBreak> ) →

Descrição
Define que será impresso o rodapé do relatórioquebrada página após a impressão do totalizador

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lTPageBreak	Lógico	Se verdadeiro, aponta a quebra de página após a impressão do totalizador

Painel

ShowHeader

SetTotalText

Sintaxe
TReport():ShowHeaderSetTotalText( <uText> ) →

Descrição
Define o texto que será impresso antes da impressão dos totalizadores

Parâmetros

Nome	Tipo	Descrição	Obrigatório
uText	Character, CodeBlock	Texto a ser impresso no formato caracter ou bloco de código

Painel

ShowFooter

Sintaxe
TReport():ShowFooter( ) →

Descrição
Define que será impresso o rodapé do relatório

Painel

ShowHeader

Sintaxe
TReport():ShowHeader( ) →

Descrição
Define que será impresso o cabeçalho do relatório que será impresso o cabeçalho do relatório

Painel

ShowParamPage

Sintaxe
TReport():ShowParamPage( ) →

Descrição
Define que será impressa a página de parâmetros do relatório

...

Painel

XmlLoad

Sintaxe
TReport():XmlLoad( <cXml> <uXml> ) →

Descrição
Carrega um layout personalizado pelo usuário

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cXmluXml	Caracter, Array	Arquivo do tipo XML com as personalizações do usuário	X

Painel

XmlSave

Sintaxe
TReport():XmlSave( ) → lRetaXml

Descrição
Salva um layout personalizado pelo usuárioRetorna um array com o layout do TReport atual.

O array contém o layout em formato XML, é retornando em formato de array para evitar problemas em relação ao tamanho máximo de strings.

Painel

XlsNewCell

Sintaxe
TReport():XlsNewCell( <c> , <lIndex> , <nCol> , <cStyle> , <nCells> , <nWidth> , <cType> ) →

Descrição
Adiciona uma célula na geração em planilha

Parâmetros

Nome	Tipo	Descrição
c	Caracter	Informação a ser inserida na célula
lIndex	Lógico	Controla numeração de colunas na planilha
nCol	Numérico	Coluna posicionada
cStyle	Caracter	Estilo da célula
nCells	Numérico	Quantidade de células utilizadas para a informação (Mesclar)
nWidth	Numérico	Largura da célula
cType	Caracter	Tipo de dado. C-Caracter, N-Numérico, L-Lógico

...

Painel

XlsNewStyle

Sintaxe
TReport():XlsNewStyle( <cID> , <cName> , <nAlign> , <aFont> , <aBorder> , <lWrapText> , <cType> ) →

Descrição
Cria um estilo para utilizar nas criações das células

Parâmetros

Nome	Tipo	Descrição
cID	Caracter	ID do estilo
cName	Caracter	Nome do estilo
nAlign	Numérico	Tipo de alinhamento. 1-Esquerda, 2-Centralizado, 3-Direita
aFont	Array	Array contendo a fonte. Elementos: 1-Fonte, 2-Tamanho
aBorder	Array	Array contendo a borda. Elementos: 1-“Bottom”,”Left”,”Right”,”Center”, 2=Largura da borda
lWrapText	Lógico	Aponta quebra de linha automática
cType	Caracter	Tipo de dado. C-Caracter, N-Numérico, L-Lógico

Painel

XlsSave

Sintaxe
TReport():XlsSave( ) →

Descrição
Compatibilidade – Não utilizado

...

Painel

SetUseGC

Sintaxe
TReport():SetUseGC( lUseGC ) →

Descrição
Define se o relatório poderá utilizar o conceito de gestão de empresas

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lUseGC	Lógico	Se falso, indica que o relatório não utilizará o conceito de gestão de empresas. Caso não seja informado o parâmetro o valor default é verdadeiro.

Painel

GetGCList

Sintaxe
TReport():GetGCList() → aFilterGC

Descrição
Retorna um array contendo a lista de grupos, empresas, unidade de negócio e filiais selecionadas na tela de gestão de empresas.

Retorno

Array contendo a lista de grupos, empresas, unidade de negócio e filiais selecionadas na tela de gestão de empresas.

Painel

xlsxTypeWrite

Sintaxe
TReport():xlsxTypeWrite( <nXlsxTypeWrite> )

Descrição
Informa ao TReport como a geração do XLSX deve ser efetuada, sendo que cada opção leva a cenários de maior performance ou maior consumo de memória, logo essa opção deve ser utilizada conforme necessidade específica de um relatório, normalmente relatórios com grande volume de dados.

Parâmetros

Nome

Tipo

Descrição

Obrigatório

nXlsxTypeWrite

Numeric

Tipo da geração de planilha XLSX, sendo valores de 0 a 3:

0: Gera o xlsx de acordo com as regras do TReport (default)
1: Gera o xlsx em arquivo (possui limitações)
2: Gera o xlsx em banco de dados (baixo consumo de memória)
3: Gera o xlsx em memória (alta performance)

Importante: A geração em arquivo (valor 1) é limitada e deve ser utilizada somente em relatório que possuam apenas uma seção, caso contrário, os dados podem ficar agrupados na última worksheet criada, portanto, essa opção deve ser utilizada com cautela e deve ser rigorosamente homologada.

Caso o método seja chamado durante a impressão, seu valor não será acatado.

Observação

Esse método está disponível na lib 20240812 ou superior
O valor enviado é repassado para a classe responsável por gerar a planilha XLSX: FWMsExcelXlsx
O método precisa ser chamado antes da ativação do TReport, ou seja, durante sua definição, normalmente na função ReportDef

Páginas filhas

Versões comparadas

Versão antiga 20

Nova versão Atual

Chave

Métodos:

AddBreak

GetParam

GetRightAlignPrinter

GetWidth

HideFooter

HideFooter

LoadDefault

LoadLayout

New

PageTotalInLine

PageTotalText

PrintGraphic

PrintHeader

SetDevice

SetPxLeftMargin

SetRightAlignPrinter

SetRow

Sintaxe
TReport():SetTitleSetRow( <cTitle> <nRow> ) →

Descrição
Define o título a margem à esquerda em pixel do relatório

Parâmetros
Nome Tipo Descrição Obrigatório
cTitlenRow Lógico Numérico Número da linha a ser impressaTítulo do relatório X

SetStartPage

SetTitle

SetTotalInLine

SetTotalPageBreak

SetTotalText

ShowFooter

ShowHeader

ShowParamPage

XmlLoad

XmlSave

XlsNewCell

XlsNewStyle

XlsSave

SetUseGC

GetGCList

xlsxTypeWrite

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 20

Nova versão Atual

Chave

Métodos:

AddBreak

GetParam

GetRightAlignPrinter

GetWidth

HideFooter

HideFooter

LoadDefault

LoadLayout

New

PageTotalInLine

PageTotalText

PrintGraphic

PrintHeader

SetDevice

SetPxLeftMargin

SetRightAlignPrinter

SetRow

SintaxeTReport():SetTitleSetRow( <cTitle> <nRow> ) →DescriçãoDefine o título a margem à esquerda em pixel do relatórioParâmetrosNomeTipoDescriçãoObrigatóriocTitlenRowLógicoNuméricoNúmero da linha a ser impressaTítulo do relatórioX

SetStartPage

SetTitle

SetTotalInLine

SetTotalPageBreak

SetTotalText

ShowFooter

ShowHeader

ShowParamPage

XmlLoad

XmlSave

XlsNewCell

XlsNewStyle

XlsSave

SetUseGC

GetGCList

xlsxTypeWrite

Sintaxe
TReport():SetTitleSetRow( <cTitle> <nRow> ) →

Descrição
Define o título a margem à esquerda em pixel do relatório

Parâmetros
Nome Tipo Descrição Obrigatório
cTitlenRow Lógico Numérico Número da linha a ser impressaTítulo do relatório X