Histórico da Página

...

Esta classe herda as propriedades e métodos da classe TRSECTION.

Aviso

title	Planilha/Formato Tabela

Quando o formato do relatório é Planilha/Formato Tabela, toda a definição do esqueleto do relatório é definido no ReportDef.

Caso crie uma célula no ReportDef e depois utilize o método HideHeader, o mesmo não surtirá efeito, ou seja, o header da célula irá aparecer no relatório.

Aviso

title	Alinhamento de células à direita

Consultar documentação: Células com alinhamento à direita

Métodos:

Painel

CanPrint

Sintaxe
TRCell():CanPrint( ) →

Descrição
Valida se a célula pode ser impressa

...

Painel

New

Sintaxe
TRCell():New( <oParent> , <cName> , <cAlias> , <cTitle> , <cPicture> , <nSize> , <lPixel> , <bBlock> , <cAlign> , <lLineBreak> , <cHeaderAlign> , <lCellBreak> , <nColSpace> , <lAutoSize> , <nClrBack> , <nClrFore> , <lBold> ) →

Descrição
Método construtor da classe TRCell

Se o nome da célula informada for encontrada no Dicionário de Campos (SX3), as informações do campo serão carregadas para a célula, respeitando os parâmetros de título, picture e tamanho. Dessa forma o relatório sempre estará atualizado com as informações do Dicionário de Campos (SX3).

O nome da célula será utilizado junto ao alias informado pelo parâmetro como conteúdo para a impressão da célula, como por exemplo a impressão do campo A1_COD da tabela SA1.
Se for informado o parâmetro com o bloco de código, o retorno deste será utilizado como conteúdo para impressão da célula, com a picture, tamanho e título definidos para a célula. Assim sendo, é possível criar células calculadas com formato de impressão baseada no Dicionário de Campos (SX3).

Parâmetros

Nome	Tipo	Descrição
oParent	Objeto	Objeto da classe TRSection que a célula pertence
cName	Caracter	Nome da célula
cAlias	Caracter	Tabela utilizada pela célula
cTitle	Caracter	Título da célula
cPicture	Caracter	Mascara da célula
nSize*	Numérico	Tamanho da célula
lPixel	Lógico	Aponta se o tamanho foi informado em pixel
bBlock	Bloco de Código	Bloco de código com o retorno do campo
cAlign	Caracter	Alinhamento da célula. “LEFT”, “RIGHT” e “CENTER”
lLineBreak	Lógico	Quebra linha se o conteúdo estourar o tamanho do campo
cHeaderAlign	Caracter	Alinhamento do cabeçalho da célula. “LEFT”, “RIGHT” e “CENTER”
lCellBreak	Lógico	Compatibilidade – Não utilizado
nColSpace	Numérico	Espaçamento entre as células
lAutoSize**	Lógico	Ajusta o tamanho da célula com base no tamanho da página e as informações impressas
nClrBack	Numérico	Cor de fundo da célula
nClrFore	Numérico	Cor da fonte da célula
lBold	Lógico	Imprime a fonte em negrito

Aviso

*É recomendada a definição de tamanho pelo parâmetro nSize, pois quando não está definido e entra nas situações de auto ajuste de tamanho pode acontecer problemas na impressão.

**Para detalhes sobre auto ajuste verifique a documentação Ajuste automático de tamanho das células nas seções (autosize).

Painel

Picture

Sintaxe
TRCell():Picture( ) →

Descrição
Retorna a máscara de impressão da célula

Retorno
Máscara de impressão

...

Painel

SetAlign

Sintaxe
TRCell():SetAlign( <uAlign> ) →

Descrição
Define o alinhamento da célula na impressão

Parâmetros

Nome	Tipo	Descrição	Obrigatório
uAlign	Caracter	Tipo Caracter: "LEFT" – - esquerda, "RIGHT" – - direita e "CENTER" - centro Tipo Númerico: 1-Esquerda, 2-Centro e 3-Direita

Painel

SetAutoWidth

Sintaxe
TRCell():SetAlign( <nAutoWidth> ) →

Descrição
Aponta a largura da célula gerada automaticamente pelo cálculo de posicionamento das células que atingirem a largura máxima da página

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nAutoWidth	Numérico	Largura da célula

Painel

SetBlock

Sintaxe
TRCell():SetBlock( <bBlock> ) →

Descrição
Define o bloco de código que retornará o conteúdo de impressão da célula. Definindo o bloco de código para a célula, esta não utilizara mais o nome mais o alias para retornar o conteúdo de impressão

Parâmetros

Nome	Tipo	Descrição	Obrigatório
bBlock	Bloco de Código	Bloco de código que retorna o conteúdo

Painel

SetBorder

Sintaxe
TRCell():SetBorder( <uBorder> , <nWeight> , <nColor> , <lHeader> ) →

Descrição
Define as bordas da célula

Parâmetros

Nome	Tipo	Descrição
uBorder	Bloco de Código	Bloco de código que retorna o conteúdo
nWeight	Numérico	Largura da borda
nColor	Numérico	Cor da borda
lHeader	Lógico	Aponta se é borda de cabeçalho

Retorno
Objeto do tipo TRBorder

Painel

SetCanPrint

Sintaxe
TRCell():SetCanPrint( <bCanPrint> ) →

Descrição
Define o bloco de código que será utilizado para validar se a célula poderá ser impressa

Parâmetros

Nome	Tipo	Descrição	Obrigatório
bCanPrint	Bloco de Código	Bloco de código com a validação da célula

Painel

SetCBox

Sintaxe
TRCell():SetCBox( <cBox> ) →

Descrição
Define que a célula irá imprimir a descrição do item de um campo que tenha o formato ComboBox, utilizado no Dicionário de Campos (SX3)

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cBox	Caracter	O formato do parâmetro é o mesmo utilizado no Dicionário de Campos (SX3), como no exemplo abaixo: oCell:SetCBox('1=Sim;2=Não') Na impressão será utilizado a descrição do item. No exemplo acima se o conteúdo da célula for '1', será impresso 'Sim', sendo que o método já irá calcular o tamanho da célula baseado na maior descrição informada

Painel

SetCellBreak

Sintaxe
TRCell():SetCellBreak( ) →

Descrição
Compatibilidade – Não utilizado

Painel

SetHeaderAlign

Sintaxe
TRCell():SetHeaderAlign( <uAlign> ) →

Descrição
Define o alinhamento do cabeçalho da célula na impressão

Parâmetros

Nome	Tipo	Descrição	Obrigatório
uAlign	Caracter / Numérico	Tipo Caracter: "LEFT" - esquerda, "RIGHT" - direita e "CENTER" - centro Tipo Numérico: 1 - Esquerda, 2 - Centro e 3 - Direita

Painel

SetNegative

Sintaxe
TRCell():SetNegative( <cNegative> ) →

Descrição
Define o sinal de negativo utilizado na impressão

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cNegative	Caracter	Tipo Caracter: "PARENTHESES" ( ) ou "SIGNAL" -

Painel

SetPicture

Sintaxe
TRCell():SetPicture( <cPicture> ) →

Descrição
Define a mascara de impressão da célula

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cPicture	Caracter	Máscara da célula

Painel

SetPrintCell

Sintaxe
TRCell():SetPrintCell( <lPrintCell> ) →

Descrição
Define se a célula será impressa

Parâmetros

Nome	Tipo	Descrição	Obrigatório
lPrintCell	Lógico	Se verdadeiro, imprime a célula

Painel

SetRow

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

Descrição
Quantidade de linhas para impressão das bordas

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nRow	Numérico	Quantidade de linhas

Painel

SetRowDiff

Sintaxe
TRCell():SetRowDiff( <nRowDiff> ) →

Descrição
Quantidade de linhas a serem consideradas na impressão das bordas

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nRowDiff	Numérico	Quantidade de linhas

Painel

SetSize

Sintaxe
TRCell():SetSize( <nSize> , <lPixel> ) →

Descrição
Define o tamanho da célula

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nSize	Numérico	Tamanho da célula
lPixel	Lógico	Aponta se o tamanho é calculado em pixel

Painel

SetTitle

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

Descrição
Define o título da célula

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cTitle	Caracter	Título da célula

Painel

SetType

Sintaxe
TRCell():SetType( <cType> ) →

Descrição
Define o tipo de dado da célula

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cType	Caracter	Tipo de dado

Painel

SetValue

Sintaxe
TRCell():SetValue( <uValue> ) →

Descrição
Define um valor constante para a célula

Parâmetros

Nome

Tipo

Descrição

Obrigatório

uValue

Valor constante

Definindo um valor constante para a célula, esta não utilizara o nome mais o alias para impressão do conteúdo, ou seja, a célula passará a se comportar como um variável de um programa.
Se o parâmetro não for informado (Nulo), então a célula deixará de usar o valor constante, voltando a imprimir seu conteúdo utilizando nome mais alias.

Painel

XmlLoad

Sintaxe
TRCell():XmlLoad( <oXml> ) →

Descrição
Carrega uma célula do layout personalizado pelo usuário

Parâmetros

Nome	Tipo	Descrição	Obrigatório
oXml	Objeto	Objeto do tipo XML com as personalizações da célula

Painel

XmlSave

Sintaxe
TRCell():XmlSave( ) →

Descrição
Salva a célula no layout personalizado pelo usuário

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Métodos:

CanPrint

New

Picture

SetAlign

SetAutoWidth

SetBlock

SetBorder

SetCanPrint

SetCBox

SetCellBreak

SetHeaderAlign

SetNegative

SetPicture

SetPrintCell

SetRow

SetRowDiff

SetSize

SetTitle

SetType

SetValue

XmlLoad

XmlSave