TRSection

Reviso: 03/05/2006
Abrangncia
Verso 8.11
Descrio
Seo de um relatrio que utiliza a classe TReport.
A classe TRSection pode ser entendida como um layout do relatrio, por conter clulas,
quebras e totalizadores que daro um formato para sua impresso.
Com a classe TRSection possvel definir uma query, filtro ou ndice com filtro
(IndRegua) que ser utilizada por ela para processamento do relatrio, atravs do
mtodo Print e utilizando as clulas de posicionamento (TRPosition) e componente de
posicionamento de seo (TRPosSection), sem a necessidade de escrever um fonte para
processar os resultados da query, filtro ou ndice com filtro.
Mtodos
Mtodo

New

Parent
Report
PageBreak
HeaderBreak
HeaderSection
Visible
Alias
Show

Descrio
Mtodo construtor da classe TRSection
No parametro onde informado as tabelas utilizadas pela
seo, a primeira ser a principal, sendo utilizada para o
processamento pelo mtodo Print. As outras tabelas sero
utilizadas para que o usurio possa incluir os campos como
clula.
O relacionamento entre as tabelas poder ser feito pela query ou
ento pelo uso dos objetos da classe TRPosition.
Dos elementos do parametro onde so informadas as ordens
utilizada pela seo sero criados os objetos da classe TROrder
automaticamente, utilizando como ndice da tabela principal a
ordem do elemento no vetor.
Retorna o objeto pai da classe TRSection
Retorna o objeto da classe TReport que a classe TRSection
pertence
Retorna se salta a pgina na quebra de seo
Retorna se cabealho das clulas ser impresso aps uma quebra
(TRBreak)
Retorna se cabealho das clulas ser impresso na quebra de
seo
Retorna se o componente esta habilitada para impresso
Retorna o alias utilizado pela query da seo, que foi definida
pelo Embedded SQL com os mtodos BeginQuery e EndQuery
Habilita a impresso do componente

Hide
lReadOnly

Init

Desabilita a impresso da seo, porm todas as linhas sero

processadas, somente no aparecero no relatrio.
Retorna se o usurio pode alterar o layout da seo
Inicializa seo.
No necessrio executar o mtodo Init se for utilizar o mtodo
Print, j que este faz o controle de inicializao e finalizao das
sees.
Caso no esteja utilizando o mtodo Print, sempre execute o
mtodo Init para inicializar a seo, para controle de quebra de
pgina entre sees, impresso do cabealho das clulas e para
outros tratamentos internos do componente.
Finaliza seo inicializada pelo mtodo Init.
No necessrio executar o mtodo Finish se for utilizar o
mtodo Print, j que este faz o controle de inicializao e
finalizao das sees.

Finish

PrintLine

Print

Cell
Order
LoadCells
LoadOrder
SetPageBreak
SetHeaderBreak
SetHeaderSection
SetReadOnly

Caso no esteja utilizando o mtodo Print, sempre execute o

mtodo Finish ao finalizar uma seo, para controle da
impresso dos totalizadores das quebras e dos que esto
habilitados para o final da seo, para controle de quebra de
pgina entre sees e para outros tratamentos internos do
componente.
Imprime a linha baseado nas clulas selecionadas pelo usurio
Processa as informaes da tabela principal ou da query definida
pelo Embedded SQL com os mtodos BeginQuery e EndQuery
O mtodo Print faz o loop na tabela ou na query, executando o
mtodo PrintLine para cada linha e o mtodo Print de todas as
sees filhas. Nas sees filhas, o posicionamento inicial pode
ser baseado na query da seo pai (atravs do mtodo
SetParentQuery) ou atravs da regra informada pelo mtodo
SetRelation, junto com a regra informada pelo mtodo
SetParentFilter que controla a sada do loop.
Retorna objeto da classe TRCell (clula) baseado no parametro
informado.
Retorna objeto da classe TROrder (ordem) basead no parametro
informado
Carrega campos do Dicionrio de Campos (SX3) como clulas
da seo, respeitando nvel, uso e contexto do campo
Carrega ndices do Dicionrio de ndices (SIX) como ordem da
seo
Define se salta a pgina na quebra de seo
Define se imprime cabealho das clulas aps uma quebra
(TRBreak)
Define de imprime cabealho das clulas na quebra de seo
Define se o usurio no poder alterar o layout da seo, ou seja,
no poder remover as clulas pr-definidas.
As clulas que forem adicionadas na seo sero impressas na
prxima pgina, aps ter impresso as clulas pr-definidas.

GetQuery

BeginQuery

EndQuery

SetParentQuery
SetParentFilter

SetFilter

SetOrder
SetIdxOrder
GetOrder
GetIdxOrder

SetRelation

Retorna a query que foi definida pelo Embedded SQL com

os mtodos BeginQuery e EndQuery, j com as clulas
selecionadas e filtro criado pelo usurio e as perguntas tipo
Range incluidas.
Indica que ser utilizado o Embedded SQL para criao de uma
nova query que ser utilizada pela seo
Indica a query criada utilizando o Embedded SQL para a seo.
O mtodo EndQuery ira juntar na query as clulas selecionadas e
o filtro criado pelo usurio, mais a expresso das perguntas do
tipo Range, que foram convertidas anteriormente pela funo
MakeSQLExpr.
Aps sua execuo a query esta pronta para ser utilizada tanto
pela classe TRSection como para o fonte que esta criando os
componentes, sem a necessidade de utilizar TCGenQuery,
ChangeQuery e TCSetField.
Define se a seo filha utilizara a query da seo pai no
processamento do mtodo Print
Define a regra de sada do loop de processamento do mtodo
Print das sees filhas
Define um filtro ou um ndice com filtro (IndRegua) para a
tabela princiapal da seo.
Se no informado o parametro com a chave de ndice, ser
executado SET FILTER TO com o primeiro parametro, seno
ser criado um ndice com filtro (IndRegua) e sua ordem ser
retornada pelo mtodo GetIdxOrder
Define a ordem (TROrder) que ser utilizada pela seo
Define uma ordem de ndice para a tabela principal
Retorna a ordem selecionada pelo usurio
Retorna o ndice utilizado pela tabela principal da seo para
processamento pelo mtodo Print.
Se o retorno for zero, ento a seo esta utilizando uma ordem
selecionada pelo usurio (TROrder)
Define a frmula de relacionamento de uma seo filha com sua
seo pai, caso no utilize a query da seo pai (SetParentQuery)
O mtodo SetRelation ir criar o componente TRRelation
apresentado no documento 'Estrutura do componente TReport',
que faz o controle do relacionamento entre as sees.