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

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	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> ) 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

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
uTextLógico	Character, CodeBlock	Texto a ser impresso no formato caracter ou bloco de código

...

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

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.
Parâmetros

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 28

Nova versão Atual

Chave

Métodos:

AddBreak

GetParam

GetRightAlignPrinter

GetWidth

HideFooter

HideFooter

LoadDefault

LoadLayout

New

SetPxLeftMargin

SetRightAlignPrinter

SetRow

SetStartPage

SetTotalText

XmlLoad

XmlSave

XlsNewCell

XlsNewStyle

XlsSave

GetGCList

xlsxTypeWrite