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

Painel

HideFooter

Sintaxe
TReport():HideFooter( ) →

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

...

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âmetrosNome	Tipo	Descrição	Obrigatório
cLayout	Caracter	Layout a ser carregado	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

SetPreview

Sintaxe
TReport():SetPreview( <lPreview> ) →

Descrição
Define se será apresentada a visualização do relatório antes da impressão física

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lPreview	Lógico	Se verdadeiro, será apresentada a visualização antes da impressão

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

Painel

SetRightAlignPrinter

Sintaxe
TReport():SetRightAlignPrinter( <lAlignPrinter> ) →

Descrição
Seta 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
lAlignPrinter	Lógico	Se verdadeiro, utiliza o alinhamento do binário para células à direita	X

Informações

title	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

Sintaxe
TReport():SetRow( <nRow> ) →

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

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nRow	Numérico	Número da linha a ser impressa	X

Painel

SetStartPage

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

Painel

SetTitle

Sintaxe
TReport():SetTitle( <cTitle> ) →

Descrição
Define o título do relatório

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cTitle	Lógico	Título do relatório	X

Painel

SetTotalInLine

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

Descrição
Define se os totalizadores serão impressos em linha ou coluna

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lTotalInLine	Lógico	Se falso, imprime em linha

Painel

SetTotalPageBreak

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

Descrição
Define que será quebrada 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

SetTotalText

Sintaxe
TReport():SetTotalText( <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

Painel

ShowParamPage

Sintaxe
TReport():ShowParamPage( ) →

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

Painel

SkipLine

Sintaxe
TReport():SkipLine( <nSkip> ) →

Descrição
Salta linhas na impressão

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nSkip	Numérico	Quantidade de linhas a serem saltadas

Painel

StartPage

Sintaxe
TReport():StartPage( ) →

Descrição
Inicializa um nova página para impressão

Painel

ThinLine

Sintaxe
TReport():ThinLine( ) →

Descrição
Desenha uma linha simples, iniciando posição da linha atual de impressão com a largura da página

Painel

Title

Sintaxe
TReport():Title( ) → cTitle

Descrição
Retorna o título do relatório

Retorno
cTitle - Caracter - Título do relatório

Painel

TotalText

Sintaxe
TReport():TotalText( ) → cTitle

Descrição
Retorna o texto que será impresso no totalizador geral do relatório

Painel

TotalInLine

Sintaxe
TReport():TotalInLine( ) → lRet

Descrição
Retorna se a impressão dos totalizadores será em linha

Retorno
lRet - Lógico

Painel

XmlLoad

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

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

Parâmetros

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

Painel

XmlSave

Sintaxe
TReport():XmlSave( ) → aXml

Descrição
Retorna 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

XlsNewCol

Sintaxe
TReport():XlsNewCol( <nCol> , <nWidth> ) →

Descrição
Adiciona uma coluna na geração em planilha

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nCol	Numérico	Coluna posicionada	X
nWidth	Numérico		X

Painel

XlsNewRow

Sintaxe
TReport():XlsNewRow( <lIncRow> ) →

Descrição
Adiciona uma linha na geração em planilha

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lIncRow	Lógico	Aponta se deverá ser adicionada uma linha

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

Histórico da Página

Versões comparadas

Versão antiga 19

Nova versão Atual

Chave

Métodos:

AddBreak

GetParam

GetRightAlignPrinter

GetWidth

HideFooter

HideFooter

LoadDefault

LoadLayout

New

PageTotalInLine

PageTotalText

PrintGraphic

PrintHeader

SetDevice

SetPreview

SetPxLeftMargin

SetRightAlignPrinter

SetRow

SetStartPage

SetTitle

SetTotalInLine

SetTotalPageBreak

SetTotalText

ShowFooter

ShowHeader

ShowParamPage

SkipLine

StartPage

ThinLine

Title

TotalText

TotalInLine

XmlLoad

XmlSave

XlsNewCell

XlsNewCol

XlsNewRow

XlsNewStyle

XlsSave

SetUseGC

GetGCList

xlsxTypeWrite