Manual do TReport

Descrio
Classe de impresso que substitui as funes SetPrint, SetDefault, RptStatus e Cabec.
A classe TReport permite que o usurio personalie as informaes que sero apresentadas no relat!rio,
alterando fonte "tipo, taman#o, etc$, cor, tipo de lin#as, cabeal#o, rodap%, etc.
&strutura do componente TReport'
( relat!rio "TReport$ cont%m ) ou mais sees "TRSection$*
+ma seo "TRSection$ pode conter ) ou mais sees*
A seo "TRSection$ cont%m c%lulas pr%,definidas e c%lulas selecionadas pelo usurio*
A seo "TRSection$ tamb%m cont%m as quebras "TR-rea.$ para impresso de totaliadores
"TR/unction$*
(s totaliadores so inclu0dos pela seo que automaticamente inclui no relat!rio "TReport$.
Mtodos
Mtodo Descrio
New 1%todo construtor da classe TReport.
SetTitle Define o t0tulo do componente.
SetParam
Define os parametros que sero utiliados pelo usurio para confi2urar o
relatorio.
Preview Apresenta pre3ie4 do relat!rio.
SetAction
Define o bloco de c!di2o que ser e5ecutado quando o usurio confirmar a
impresso
Print
6nicia impresso do relat!rio e5ecutando o parametro bAction informado nos
m%todos 7e4, SetAction ou PrintDialo2.
&sse m%todo % e5ecutado pelo m%todo PrintDialo2 quando o usurio confirma a
impresso do relat!rio.
PrintDialog
Apresenta a tela de impresso para o usurio confi2urar o relat!rio.
( m%todo PrintDialo2 e5ecuta o m%todo Print quando o usurio confirma a
impresso, e5ecutando o bloco de c!di2o informado pelo parametro bAction nos
m%todos 7e4 ou SetAction.
Cancel Retorna se o usurio cancelou a impresso do relat!rio.
SetMeter Define o total da re2ua da tela de processamento do relat!rio.
IncMeter 6ncrementa a r%2ua da tela de processamento do relat!rio
SetDescription Define a descrio do componente.
ClassName
Retorna o nome da classe do componente.
&5emplo'
oReport '8 TReport"$'7e4"91ATR:):9$
1s2Stop"oReport'Class7ame"$$ ;;Apresenta na tela 9TR&P(RT9
ReportName Retorna o nome do relat!rio "e5emplo' 1ATR:):$
Title Retorna o t0tulo do componente
Description Descrio do componente
TotalText Retorna o te5to que ser impresso antes da impresso dos totaliadores
GetParam Retorna a per2unta;bloco de c!di2o utiliada como parametro do relat!rio.
GetAction
Retorna bloco de c!di2o que ser e5ecutado pelos m%todos Print e PrintDialo2
quando usurio confirmar impresso.
FooterAtEnd Retorna se ser impressore rodap% no final da impresso
TotalInine Retorna se a impresso dos totaliadores ser em lin#a
Page!eig"t
Retorna a altura da p2ina baseado no taman#o da fol#a "A<, Carta,
etc$ informado pelo usurio
Page#idt"
Retorna a lar2ura da p2ina baseado no taman#o da fol#a "A<, Carta,
etc$ informado pelo usurio
Row Retorna a lin#a posicionada na impresso
Col Retorna a coluna posicionada na impresso
Page Retorna o n=mero da p2ina atual na impresso
Get$rientation Retorna a orientao de p2ina "Retrato ou Paisa2em$ selecionada pelo usurio.
Printing
Retorna se relat!rio esta em processo de impresso.
( status de impresso % definido pelos m%todos 6nit "que indica o in0cio da
impresso$ e o m%todo /inis# "que indica a finaliao$.
Init
6ncialia impresso.
7o % necessrio e5ecutar o m%todo 6nit se for utiliar o m%todo Print ou
PrintDialo2, > que estes faem o controle de inicialiao e finaliao da
impresso.
Caso no este>a utiliando os m%todo citados acima, sempre e5ecute o m%todo
6nit no in0dio do relat!rio para 3erificar as confi2uraes informadas pelo usurio
e inicialiar corretamente a primeira p2ina do relat!rio.
Finis"
/inalia impresso inicialiada pelo m%todo 6nit.
7o % necessrio e5ecutar o m%todo /inis# se for utiliar o m%todo Print ou
PrintDialo2, > que estes faem o controle de inicialiao e finaliao da
impresso.
Caso no este>a utiliando os m%todo citados acima, sempre e5ecute o m%todo
/inis# no final do relat!rio para impresso dos totaliadores que esto
#abilitados para o final do relat!rio, para fec#ar as quer?s e;ou ind0ces
temporrios criados pelas sees e para outros tratamentos internos do
componente.
PrintText 6mprime o te5to nas coordenadas informadas pelos parametros
EndPage /inalia um p2ina de impresso
IncRow
6ncrementa a lin#a de impresso baseado no parametro ou no 3alor definido
pelo usurio para a altura das lin#as do relat!rio.
S%ipine Salta uma lin#a baseado na altura da lin#a informada pelo usurio
SetTotalText Define o te5to que ser impresso antes da impresso dos totaliadores
SetTotalInine Define se os totaliadores sero impressos em lin#a ou coluna
SetPortrait Define orientao de p2ina do relat!rio como retrato
Setandscape Define a orientao de p2ina do relat!rio como paisa2em
SetPreview Define se ser apresentado o pre3ie4 o relat!rio no final da impresso
GetF&nction
Retorna ob>eto da classe TR/unction "totaliadores$ baseado no parametro
informado.
Section Retorna ob>eto da classe TRSection "seo$ baseado no parametro informado.
Sa'
6mprime te5to nas coordenadas informadas pelos parametros, utiliando as
especificaes do ob>eto T/ont, cor da fonte e cor de fundo
Sa'(itmap 6mprime uma ima2em nas coordenadas informadas pelos parametros
ine Desen#a uma lin#a baseado nas coordenadas informadas pelos parametros,
utiliando as especificaes do ob>eto TPen.
(ox
Desen#a uma cai5a baseado nas coordenadas informadas pelos parametros,
utiliando as especificaes do ob>eto TPen.
FillRect
Preenc#e um retan2ulo na impresso utiliando as especificaes do ob>eto
T-rus#.
T"inine
Desen#a uma lin#a simples iniciando na lin#a atual de impresso com a lar2ura
da p2ina
Fatine
Desen#a uma lin#a com altura maior que a do m%todo T#in@ine, iniciando na
lin#a atual de impresso com a lar2ura da p2ina
TReport sem usar mtodo TRSection:Print
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse() //verifica se relatorios personaliaveis esta disponivel
!er"unte("MTR#$%"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection
oReport '( TReport()',e-("M.TR#$%"&"Relacao das +u"estoes de /rca0entos"&"MTR#$%"&12oReport2
!rintReport(oReport)3&"*ste relatorio ira i0pri0ir a relacao das +u"estoes de 4enda confor0e os para0etros
solicitados.")
o+ection '( TR+ection()',e-(oReport&/e0To.nsi("+u"estoes de /rca0entos")&1"+56"&"+57"&"+58"3)
TR9ell()',e-(o+ection&"56:!R/)UT/"&"+56")
TR9ell()',e-(o+ection&"58:)*+9"&"+58")
TR9ell()',e-(o+ection&"56:6*R.!4"&"+56")
TR9ell()',e-(o+ection&"56:6*R./!"&"+56")
TR9ell()',e-(o+ection&"56:6*R./!I"&"+56")
TR9ell()',e-(o+ection&"56:6*R.*M!"&"+56")
TR9ell()',e-(o+ection&"57:+*;U*,9"&"+57")
TR9ell()',e-(o+ection&"57:9/)9/M!"&"+57")
TR9ell()',e-(o+ection&"58:)*+9"&"+58")
TR9ell()',e-(o+ection&"57:;U.,T"&"+57")
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection '( oReport'+ection(8)
)<+elect.rea("+56")
)<+et/rder(8)
)<+ee=(>Filial()?M4:!.R#8&.T.)
oReport'+etMeter(Rec9ount())
@hile ( A*of() ..nd. >Filial("+56") (( +56BC56:FILI.L ..nd. D
+56BC56:!R/)UT/ C( M4:!.R#8 ..nd. D
+56BC56:!R/)UT/ E( M4:!.R#$ )
If oReport'9ancel()
*>it
*ndIf
)<+elect.rea("+58")
)<+et/rder(8)
)<+ee=(>Filial("+58")?+56BC56:!R/)UT/)
o+ection'Init()
o+ection'9ell("58:)*+9")'+et4alue(+58BC58:)*+9)
o+ection'9ell("56:!R/)UT/")'+ho-()
o+ection'9ell("58:)*+9")'+ho-()
o+ection'9ell("56:6*R.!4")'+ho-()
o+ection'9ell("56:6*R./!")'+ho-()
o+ection'9ell("56:6*R./!I")'+ho-()
o+ection'9ell("56:6*R.*M!")'+ho-()
d<+elect.rea("+57")
d<+et/rder(8)
d<+ee=(>Filial("+57")?+56BC56:!R/)UT/&.T.)
@hile ( A*of() ..nd. +57BC57:FILI.L (( >Filial("+57") ..nd.D
+57BC57:!R/)UT/ (( +56BC56:!R/)UT/ )
d<+elect.rea("+58")
d<+et/rder(8)
d<+ee=(>Filial("+58")?+57BC57:9/)9/M!)
o+ection'!rintLine()
o+ection'9ell("56:!R/)UT/")'7ide()
o+ection'9ell("58:)*+9")'7ide()
o+ection'9ell("56:6*R.!4")'7ide()
o+ection'9ell("56:6*R./!")'7ide()
o+ection'9ell("56:6*R./!I")'7ide()
o+ection'9ell("56:6*R.*M!")'7ide()
d<+elect.rea("+57")
d<+=ip()
*nd
)<+elect.rea("+56")
)<+=ip()
o+ection'Finish()
oReport'+=ipLine()
oReport'IncMeter()
*nd
Return
TReport sem usar mtodo TRSection:Print com sees
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse() //verifica se relatorios personaliaveis esta disponivel
!er"unte("MTR#$%"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection8
Local o+ection$
oReport '( TReport()',e-("M.TR#$%"&"Relacao das +u"estoes de /rca0entos"&"MTR#$%"&12oReport2
!rintReport(oReport)3&"*ste relatorio ira i0pri0ir a relacao das +u"estoes de 4enda confor0e os para0etros
solicitados.")
o+ection8 '( TR+ection()',e-(oReport&"!rodutos"&1"+56"&"+58"3)
TR9ell()',e-(o+ection8&"56:!R/)UT/"&"+56")
TR9ell()',e-(o+ection8&"58:)*+9"&"+58")
TR9ell()',e-(o+ection8&"56:6*R.!4"&"+56")
TR9ell()',e-(o+ection8&"56:6*R./!"&"+56")
TR9ell()',e-(o+ection8&"56:6*R./!I"&"+56")
TR9ell()',e-(o+ection8&"56:6*R.*M!"&"+56")
TR!osition(o+ection8&"+58"&8&122 >Filial("+58") ? +56BC56:!R/)UT/3)
o+ection$ '( TR+ection()',e-(o+ection8&"9o0ponentes"&1"+57"&"+58"3)
TR9ell()',e-(o+ection$&"57:+*;U*,9"&"+57")
TR9ell()',e-(o+ection$&"57:9/)9/M!"&"+57")
TR9ell()',e-(o+ection$&"58:)*+9"&"+58")
TR9ell()',e-(o+ection$&"57:;U.,T"&"+57")
TR!osition(o+ection$&"+58"&8&122 >Filial("+58") ? +57BC57:9/)9/M!3)
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection8 '( oReport'+ection(8)
Local o+ection$ '( oReport'+ection(8)'+ection(8)
)<+elect.rea("+56")
)<+et/rder(8)
)<+ee=(>Filial()?M4:!.R#8&.T.)
oReport'+etMeter(Rec9ount())
@hile ( A*of() ..nd. >Filial("+56") (( +56BC56:FILI.L ..nd. D
+56BC56:!R/)UT/ C( M4:!.R#8 ..nd. D
+56BC56:!R/)UT/ E( M4:!.R#$ )
If oReport'9ancel()
*>it
*ndIf
o+ection8'Init()
o+ection8'!rintLine()
d<+elect.rea("+57")
d<+et/rder(8)
d<+ee=(>Filial("+57")?+56BC56:!R/)UT/&.T.)
o+ection$'Init()
@hile ( A*of() ..nd. +57BC57:FILI.L (( >Filial("+57") ..nd.D
+57BC57:!R/)UT/ (( +56BC56:!R/)UT/ )
o+ection$'!rintLine()
d<+elect.rea("+57")
d<+=ip()
*nd
o+ection$'Finish()
)<+elect.rea("+56")
)<+=ip()
o+ection8'Finish()
oReport'IncMeter()
*nd
Return
TReport usando mtodo TRSection:Print com 1 seo
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse()
!er"unte("MTR%F#"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection
Local o5rea=
oReport '( TReport()',e-("MGR*!/RT"&"Relatorio de 4isitas"&"MTR%F#"&12oReport2 !rintReport(oReport)3&"Relatorio
de visitas de vendedores nos clientes")
o+ection '( TR+ection()',e-(oReport&"9lientes"&1"+.8"&"+.F"3)
TR9ell()',e-(o+ection&".8:4*,)"&"+.8")
TR9ell()',e-(o+ection&".F:,/M*"&"+.F")
TR9ell()',e-(o+ection&".8:9/)"&"+.8"&"9liente")
TR9ell()',e-(o+ection&".8:L/H."&"+.8")
TR9ell()',e-(o+ection&".8:,/M*"&"+.8")
TR9ell()',e-(o+ection&".8:ULT4I+"&"+.8")
TR9ell()',e-(o+ection&".8:T*M4I+"&"+.8")
TR9ell()',e-(o+ection&".8:9/,T.T/"&"+.8")
TR9ell()',e-(o+ection&".8:T*L"&"+.8")
o5rea= '( TR5rea=()',e-(o+ection&o+ection'9ell(".8:4*,)")&"+u< Total 4endedores")
TRFunction()',e-(o+ection'9ell(".8:9/)")&,IL&"9/U,T"&o5rea=)
TRFunction()',e-(o+ection'9ell(".8:T*M4I+")&,IL&"+UM"&o5rea=)
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection '( oReport'+ection(8)
Local c!art
Local cFiltro '( ""
#IF)*F T/!
//Transfor0a para0etros do tipo Ran"e e0 e>pressao +;L para ser utiliada na Iuery
Ma=e+Il*>pr("MTR%F#")
o+ection'5e"in;uery()
If ( 0v:par#F (( 8 )
c!art '( "J.,) (" ? )tos(d)ata5ase) ? " B .8:ULT4I+) C .8:T*M4I+J"
*lse
c!art '( "JJ"
*ndIf
5e"in+Il alias ";RG+.8"
+*L*9T .8:9/)&.8:L/H.&.8:,/M*&.8:4*,)&.8:ULT4I+&.8:T*M4I+&.8:T*L&.8:9/,T.T/&.F:,/M*
FR/M Jta<le'+.8J +.8&Jta<le'+.FJ +.F
@7*R* .8:4*,) ( .F:9/) .,) .8:FILI.L ( J>filial'+.8J .,)
.8:T*M4I+ C # .,) +.8.Jnot)elJ Je>p'c!artJ
/R)*R 5G .8:4*,)
*nd+Il
/K
!repara relatorio para e>ecutar a Iuery "erada pelo *0<edded +;L passando co0o
para0etro a per"unta ou vetor co0 per"untas do tipo Ran"e Iue fora0 alterados
pela funcao Ma=e+Il*>pr para sere0 adicionados a Iuery
K/
o+ection'*nd;uery(0v:par#L)
#*L+*
//Transfor0a para0etros do tipo Ran"e e0 e>pressao .)4!L para ser utiliada no filtro
Ma=e.dvpl*>pr("MTR%F#")
//.diciona no filtro o para0etro tipo Ran"e
If A*0pty(0v:par#L)
cFiltro ?( 0v:par#L ? " ..,). "
*ndIf
cFiltro ?( " .8:T*M4I+ C # "
If ( 0v:par#F (( 8 )
cFiltro ?( M ..,). (M?)to9(d)ata5ase)?MB.8:ULT4I+) C .8:T*M4I+M
*ndIf
o+ection'+etFilter(cFiltro&".8:4*,)")
TR!osition()',e-(oReport'+ection(8)&"+.F"&8&122 >Filial() ? +.8BC.8:4*,)3)
#*,)IF
o+ection'!rint()
Return
TReport usando mtodo TRSection:SetParentQuery
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse()
!er"unte("MTR%F#"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection8
Local o+ection$
oReport '( TReport()',e-("MGR*!/RT"&"Relatorio de 4isitas"&"MTR%F#"&12oReport2 !rintReport(oReport)3&"Relatorio
de visitas de vendedores nos clientes")
o+ection8 '( TR+ection()',e-(oReport&"4endedores"&"+.F")
TR9ell()',e-(o+ection8&".F:9/)"&"+.F"&"4endedor")
TR9ell()',e-(o+ection8&".F:,/M*"&"+.F")
TRFunction()',e-(o+ection8'9ell(".F:9/)")&,IL&"9/U,T"&,IL&,IL&,IL&,IL&.F.)
o+ection$ '( TR+ection()',e-(o+ection8&"9lientes"&"+.8")
TR9ell()',e-(o+ection$&".8:9/)"&"+.8"&"9liente")
TR9ell()',e-(o+ection$&".8:L/H."&"+.8")
TR9ell()',e-(o+ection$&".8:,/M*"&"+.8")
TR9ell()',e-(o+ection$&".8:ULT4I+"&"+.8")
TR9ell()',e-(o+ection$&".8:T*M4I+"&"+.8")
TR9ell()',e-(o+ection$&".8:9/,T.T/"&"+.8")
TR9ell()',e-(o+ection$&".8:T*L"&"+.8")
TRFunction()',e-(o+ection$'9ell(".8:9/)")&,IL&"9/U,T")
TRFunction()',e-(o+ection$'9ell(".8:T*M4I+")&,IL&"+UM")
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection8 '( oReport'+ection(8)
Local o+ection$ '( oReport'+ection(8)'+ection(8)
Local cFiltro '( ""
#IF)*F T/!
o+ection8'5e"in;uery()
If ( 0v:par#F (( 8 )
c!art '( "J.,) (" ? )tos(d)ata5ase) ? " B .8:ULT4I+) C .8:T*M4I+J"
*lse
c!art '( "JJ"
*ndIf
5e"in+Il alias ";RG+.F"
+*L*9T .8:9/)&.8:L/H.&.8:,/M*&.8:4*,)&.8:ULT4I+&.8:T*M4I+&.8:T*L&.8:9/,T.T/&.F:,/M*&.F:9/)
FR/M Jta<le'+.8J +.8&Jta<le'+.FJ +.F
@7*R* .8:4*,) ( .F:9/) .,) .8:FILI.L ( J>filial'+.8J .,)
.8:T*M4I+ C # .,) +.8.Jnot)elJ
/R)*R 5G .8:4*,)
*nd+Il
/K
!repara relatorio para e>ecutar a Iuery "erada pelo *0<edded +;L passando co0o
para0etro a per"unta ou vetor co0 per"untas do tipo Ran"e Iue fora0 alterados
pela funcao Ma=e+Il*>pr para sere0 adicionados a Iuery
K/
o+ection8'*nd;uery(0v:par#L)
o+ection$'+et!arent;uery()
o+ection$'+et!arentFilter(12c!ara02 ;RG+.FBC.8:4*,) C( c!ara0 .and. ;RG+.FBC.8:4*,) E( c!ara03&122
;RG+.FBC.F:9/)3)
#*L+*
cFiltro '( " .8:T*M4I+ C # "
If ( 0v:par#F (( 8 )
cFiltro ?( M ..,). (M?)to9(d)ata5ase)?MB.8:ULT4I+) C .8:T*M4I+M
*ndIf
o+ection$'+etFilter(cFiltro&".8:4*,)")
o+ection$'+etRelation(122 +.FBC.F:9/)3)
o+ection$'+et!arentFilter(12c!ara02 +.8BC.8:4*,) C( c!ara0 .and. +.8BC.8:4*,) E( c!ara03&122 +.FB
C.F:9/)3)
#*,)IF
o+ection8'!rint()
Return
Funes
ResetReport
Sintaxe
o(b>'ResetReport " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Reinicia 3alor do totaliador para o relat!rio
Box
Sintaxe
o(b>'-o5 " B nRo4 A , B nCol A , B n-ottom A , B nRi2#t A , C oPen D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nRo4 7um%rico @in#a inicial
nCol 7um%rico Coluna inicial
n-ottom 7um%rico @in#a final
nRi2#t 7um%rico Coluna final
oPen (b>eto (b>eto da classe TPen
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desen#a uma cai5a baseado nas coordenadas informadas pelos parametros, utiliando as especificaes
do ob>eto TPen.
ancel
Sintaxe
o(b>'Cancel " $ ,,A lCanceled
Retorno
Tipo Descrio
@!2ico Eerdadeiro se usurio cancelou impresso
Descrio
Retorna se o usurio cancelou a impresso do relat!rio.
lass!ame
Sintaxe
o(b>'Class7ame " $ ,,A cClass7ame
Retorno
Tipo Descrio
Caracter 7ome da classe
Descrio
Retorna o nome da classe do componente.
&5emplo'
oReport '8 TReport"$'7e4"91ATR:):9$
1s2Stop"oReport'Class7ame"$$ ;;Apresenta na tela 9TR&P(RT9
ol
Sintaxe
o(b>'Col " $ ,,A nCol
Retorno
Tipo Descrio
7um%rico Coluna posicionada na impresso
Descrio
Retorna a coluna posicionada na impresso
"escription
Sintaxe
o(b>'Description " $ ,,A cDescription
Retorno
Tipo Descrio
Caracter Descrio do componente
Descrio
Descrio do componente
#ndPa$e
Sintaxe
o(b>'&ndPa2e " C l/ooter D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
l/ooter @!2ico
6mprime rodap%.
Ealor padro' /also
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
/inalia uma p2ina de impresso
Fat%ine
Sintaxe
o(b>'/at@ine " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desen#a uma lin#a com altura maior que a do m%todo T#in@ine, iniciando na lin#a atual de impresso
com a lar2ura da p2ina
FillRect
Sintaxe
o(b>'/illRect " B aRect A , C o-rus# D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
aRect Arra?
Eetor com coordenadas no formato'
Flin#a inicial, coluna inicial, lin#a final, coluna finalG
o-rus# (b>eto (b>eto da classe T-rus#
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Preenc#e um retan2ulo na impresso utiliando as especificaes do ob>eto T-rus#.
Finis&
Sintaxe
o(b>'/inis# " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
/inalia impresso inicialiada pelo m%todo 6nit.
7o % necessrio e5ecutar o m%todo /inis# se for utiliar o m%todo Print ou PrintDialo2, > que estes
faem o controle de inicialiao e finaliao da impresso.
Caso no este>a utiliando os m%todo citados acima, sempre e5ecute o m%todo /inis# no final do relat!rio
para impresso dos totaliadores que esto #abilitados para o final do relat!rio, para fec#ar as quer?s
e;ou ind0ces temporrios criados pelas sees e para outros tratamentos internos do componente.
Footer't#nd
Sintaxe
o(b>'/ooterAt&nd " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna se ser impressore rodap% no final da impresso
(et'ction
Sintaxe
o(b>'HetAction " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna bloco de c!di2o que ser e5ecutado pelos m%todos Print e PrintDialo2 quando usurio confirmar
impresso.
(etFunction
Sintaxe
o(b>'Het/unction " B u/unction A $ ,,A o/unction
Parmetros
Argumento Tipo Descrio
u/unction "Iualquer$
Tipo Caracter' 6D do ob>eto
Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos
componentes TR/unction
Retorno
Tipo Descrio
(b>eto
(b>eto da classe TR/unction.
Se no for encontrado o ob>eto se2undo o parametro informado ser retornado 7ulo
Descrio
Retorna ob>eto da classe TR/unction "totaliadores$ baseado no parametro informado.
(et)rientation
Sintaxe
o(b>'Het(rientation " $ ,,A n(rientation
Retorno
Tipo Descrio
7um%rico
(rientao da p2ina'
) , Retrato
K , Paisa2em
Descrio
Retorna a orientao de p2ina "Retrato ou Paisa2em$ selecionada pelo usurio.
(etParam
Sintaxe
o(b>'HetParam " $ ,,A uParam
Retorno
Tipo Descrio
"Iualquer$ Per2unta "SL)$ ou bloco de c!di2o utiliado como parametro
Descrio
Retorna a per2unta;bloco de c!di2o utiliada como parametro do relat!rio.
*ncMeter
Sintaxe
o(b>'6nc1eter " C n6nc D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n6nc 7um%rico
Iuantidade a incrementar na r%2ua.
Ealor padro' )
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6ncrementa a r%2ua da tela de processamento do relat!rio
*ncRo+
Sintaxe
o(b>'6ncRo4 " C n6nc D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n6nc 7um%rico
Iuantidade a incrementar.
Ealor padro definida pelo usurio para a altura da lin#a
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6ncrementa a lin#a de impresso baseado no parametro ou no 3alor definido pelo usurio para a altura
das lin#as do relat!rio.
*nit
Sintaxe
o(b>'6nit " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6ncialia impresso.
7o % necessrio e5ecutar o m%todo 6nit se for utiliar o m%todo Print ou PrintDialo2, > que estes faem o
controle de inicialiao e finaliao da impresso.
Caso no este>a utiliando os m%todo citados acima, sempre e5ecute o m%todo 6nit no in0dio do relat!rio
para 3erificar as confi2uraes informadas pelo usurio e inicialiar corretamente a primeira p2ina do
relat!rio.
%ine
Sintaxe
o(b>'@ine " B nTop A , B nCol A , B n-ottom A , B nRi2#t A , C oPen D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nTop 7um%rico @in#a inicial
nCol 7um%rico Coluna inicial
n-ottom 7um%rico @in#a final
nRi2#t 7um%rico Coluna final
oPen (b>eto (b>eto da classe TPen
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desen#a uma lin#a baseado nas coordenadas informadas pelos parametros, utiliando as especificaes
do ob>eto TPen.
Pa$e
Sintaxe
o(b>'Pa2e " $ ,,A nPa2e
Retorno
Tipo Descrio
7um%rico 7=mero da p2ina
Descrio
Retorna o n=mero da p2ina atual na impresso
Pa$e,ei$&t
Sintaxe
o(b>'Pa2eMei2#t " $ ,,A nPa2eMei2#t
Retorno
Tipo Descrio
7um%rico Altura da p2ina
Descrio
Retorna a altura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio
Pa$e-idt&
Sintaxe
o(b>'Pa2eNidt# " $ ,,A nPa2eNidt#
Retorno
Tipo Descrio
7um%rico @ar2ura da p2ina
Descrio
Retorna a lar2ura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio
Pre.ie+
Sintaxe
o(b>'Pre3ie4 " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Apresenta pre3ie4 do relat!rio.
Print
Sintaxe
o(b>'Print " C lDl2 D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lDl2 @!2ico Eerdadeiro para apresentar a tela de processamento do relat!rio
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6nicia impresso do relat!rio e5ecutando o parametro bAction informado nos m%todos 7e4, SetAction ou
PrintDialo2.
&sse m%todo % e5ecutado pelo m%todo PrintDialo2 quando o usurio confirma a impresso do relat!rio.
Print"ialo$
Sintaxe
o(b>'PrintDialo2 " C bAction D $ ,,A lPrinted
Parmetros
Argumento Tipo Descrio
bAction Code,-loc.
-loco de c!di2o que ser e5ecutado quando usurio confirmar a
impresso do relat!rio
Retorno
Tipo Descrio
@!2ico Eerdadeiro se usurio confirmou impresso do relat!rio
Descrio
Apresenta a tela de impresso para o usurio confi2urar o relat!rio.
( m%todo PrintDialo2 e5ecuta o m%todo Print quando o usurio confirma a impresso, e5ecutando o bloco
de c!di2o informado pelo parametro bAction nos m%todos 7e4 ou SetAction.
PrintText
Sintaxe
o(b>'PrintTe5t " B cTe5t A , C nRo4 D , C nCol D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cTe5t Caracter Te5to que ser impresso
nRo4 7um%rico
@in#a que o te5to ser impresso.
Ealor padro' lin#a posicionada da impresso
nCol 7um%rico
Coluna que o te5to ser impresso.
Ealor padro' coluna posicionada da impresso
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6mprime o te5to nas coordenadas informadas pelos parametros
Printin$
Sintaxe
o(b>'Printin2 " $ ,,A lPrintin2
Retorno
Tipo Descrio
@!2ico Eerdadeiro se relat!rio esta no processo de impresso
Descrio
Retorna se relat!rio esta em processo de impresso.
( status de impresso % definido pelos m%todos 6nit "que indica o in0cio da impresso$ e o m%todo /inis#
"que indica a finaliao$.
Report!ame
Sintaxe
o(b>'Report7ame " $ ,,A cReport
Retorno
Tipo Descrio
Caracter 7ome do relat!rio
Descrio
Retorna o nome do relat!rio "e5emplo' 1ATR:):$
Ro+
Sintaxe
o(b>'Ro4 " $ ,,A nRo4
Retorno
Tipo Descrio
7um%rico @in#a posicionada na impresso
Descrio
Retorna a lin#a posicionada na impresso
Say
Sintaxe
o(b>'Sa? " B nRo4 A , B nCol A , B cTe5t A , C o/ont D , C nNidt# D , C nClrTe5t D , C n-.1ode D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nRo4 7um%rico @in#a para impresso do te5to
nCol 7um%rico Coluna para impresso do te5to
cTe5t Caracter Te5to que ser impresso
o/ont (b>eto (b>eto da classe T/ont
nNidt# 7um%rico Taman#o em pi5el do te5to para impresso
nClrTe5t 7um%rico Cor da fonte
n-.1ode 7um%rico Cor de fundo
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6mprime te5to nas coordenadas informadas pelos parametros, utiliando as especificaes do ob>eto
T/ont, cor da fonte e cor de fundo
SayBitmap
Sintaxe
o(b>'Sa?-itmap " B n@in#a A , B nCol A , B c-itmap A , C nNidt# D , C nMei2#t D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n@in#a 7um%rico @in#a para impresso da ima2em
nCol 7um%rico Coluna para impresso da ima2em
c-itmap 7um%rico 7ome da ima2em "arqui3o ou resource compilado no reposit!rio$
nNidt# 7um%rico @ar2ura da ima2em
nMei2#t 7um%rico Altura da ima2em
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6mprime uma ima2em nas coordenadas informadas pelos parametros
Section
Sintaxe
o(b>'Section " B uSection A $ ,,A oSection
Parmetros
Argumento Tipo Descrio
uSection "Iualquer$
Tipo Caracter' T0tulo do ob>eto
Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos
componentes TRSection
Retorno
Tipo Descrio
(b>eto
(b>eto da classe TR/unction.
Se no for encontrado o ob>eto se2undo o parametro informado ser retornado 7ulo
Descrio
Retorna ob>eto da classe TRSection "seo$ baseado no parametro informado.
Set'ction
Sintaxe
o(b>'SetAction " B bAction A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
bAction Code,-loc.
-loco de c!di2o que ser e5ecutado quando usurio confirmar a
impresso do relat!rio
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o bloco de c!di2o que ser e5ecutado quando o usurio confirmar a impresso
Set"escription
Sintaxe
o(b>'SetDescription " B cDesc A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cDesc Caracter Descrio do componente
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a descrio do componente.
Set%andscape
Sintaxe
o(b>'Set@andscape " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a orientao de p2ina do relat!rio como paisa2em
SetMeter
Sintaxe
o(b>'Set1eter " B nTotal A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nTotal 7um%rico Total da re2ua de processamento
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o total da re2ua da tela de processamento do relat!rio.
SetParam
Sintaxe
o(b>'SetParam " B uParam A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
uParam "Iualquer$ Tipo Caracter' Parametros do relat!rio cadastrado no Dicionrio de
Per2untas "SL)$
Tipo -loco de c!di2o' bloco que ser utiliado como parametro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define os parametros que sero utiliados pelo usurio para confi2urar o relatorio.
SetPortrait
Sintaxe
o(b>'SetPortrait " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define orientao de p2ina do relat!rio como retrato
SetPre.ie+
Sintaxe
o(b>'SetPre3ie4 " C lPre3ie4 D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lPre3ie4 @!2ico
Eerdadeiro para apresentar pre3ie4 no final da impresso
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se ser apresentado o pre3ie4 o relat!rio no final da impresso
SetTitle
Sintaxe
o(b>'SetTitle " B cTitle A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cTitle Caracter T0tulo do componente
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o t0tulo do componente.
SetTotal*n%ine
Sintaxe
o(b>'SetTotal6n@ine " C lTotal6n@ine D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lTotal6n@ine @!2ico
Eerdadeiro se totaliadores sero impressos em lin#a
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se os totaliadores sero impressos em lin#a ou coluna
SetTotalText
Sintaxe
o(b>'SetTotalTe5t " B cTe5to A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cTe5to Caracter Te5to para impresso antes dos totaliadores
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o te5to que ser impresso antes da impresso dos totaliadores
S/ip%ine
Sintaxe
o(b>'S.ip@ine " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Salta uma lin#a baseado na altura da lin#a informada pelo usurio
T&in%ine
Sintaxe
o(b>'T#in@ine " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desen#a uma lin#a simples iniciando na lin#a atual de impresso com a lar2ura da p2ina
Title
Sintaxe
o(b>'Title " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna o t0tulo do componente
Total*n%ine
Sintaxe
o(b>'Total6n@ine " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna se a impresso dos totaliadores ser em lin#a
TotalText
Sintaxe
o(b>'TotalTe5t " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna o te5to que ser impresso antes da impresso dos totaliadores
#xemplos
#xemplo de utili0ao da 1uno MPReport
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport8()
//Infor0ando o vetor co0 as ordens utiliadas pelo relatNrio
M!Report("MGR*!/RT8"&"+.8"&"Relacao de 9lientes"&"*ste relatNrio irO i0pri0ir a relacao de clientes"&1"!or
9odi"o"&".lfa<etica"&"!or "?RTri0(RetTitle(".8:969"))3)
Return
User Function MyReport$()
//Infor0ando para funPQo carre"ar os Rndices do )icionOrio de Sndices (+IT) da ta<ela
M!Report("MGR*!/RT$"&"+.8"&"Relacao de 9lientes"&"*ste relatNrio irO i0pri0ir a relacao de clientes"&&.T.)
Return
TReport sem usar mtodo TRSection:Print
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse() //verifica se relatorios personaliaveis esta disponivel
!er"unte("MTR#$%"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection
oReport '( TReport()',e-("M.TR#$%"&"Relacao das +u"estoes de /rca0entos"&"MTR#$%"&12oReport2
!rintReport(oReport)3&"*ste relatorio ira i0pri0ir a relacao das +u"estoes de 4enda confor0e os para0etros
solicitados.")
o+ection '( TR+ection()',e-(oReport&/e0To.nsi("+u"estoes de /rca0entos")&1"+56"&"+57"&"+58"3)
TR9ell()',e-(o+ection&"56:!R/)UT/"&"+56")
TR9ell()',e-(o+ection&"58:)*+9"&"+58")
TR9ell()',e-(o+ection&"56:6*R.!4"&"+56")
TR9ell()',e-(o+ection&"56:6*R./!"&"+56")
TR9ell()',e-(o+ection&"56:6*R./!I"&"+56")
TR9ell()',e-(o+ection&"56:6*R.*M!"&"+56")
TR9ell()',e-(o+ection&"57:+*;U*,9"&"+57")
TR9ell()',e-(o+ection&"57:9/)9/M!"&"+57")
TR9ell()',e-(o+ection&"58:)*+9"&"+58")
TR9ell()',e-(o+ection&"57:;U.,T"&"+57")
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection '( oReport'+ection(8)
)<+elect.rea("+56")
)<+et/rder(8)
)<+ee=(>Filial()?M4:!.R#8&.T.)
oReport'+etMeter(Rec9ount())
@hile ( A*of() ..nd. >Filial("+56") (( +56BC56:FILI.L ..nd. D
+56BC56:!R/)UT/ C( M4:!.R#8 ..nd. D
+56BC56:!R/)UT/ E( M4:!.R#$ )
If oReport'9ancel()
*>it
*ndIf
)<+elect.rea("+58")
)<+et/rder(8)
)<+ee=(>Filial("+58")?+56BC56:!R/)UT/)
o+ection'Init()
o+ection'9ell("58:)*+9")'+et4alue(+58BC58:)*+9)
o+ection'9ell("56:!R/)UT/")'+ho-()
o+ection'9ell("58:)*+9")'+ho-()
o+ection'9ell("56:6*R.!4")'+ho-()
o+ection'9ell("56:6*R./!")'+ho-()
o+ection'9ell("56:6*R./!I")'+ho-()
o+ection'9ell("56:6*R.*M!")'+ho-()
d<+elect.rea("+57")
d<+et/rder(8)
d<+ee=(>Filial("+57")?+56BC56:!R/)UT/&.T.)
@hile ( A*of() ..nd. +57BC57:FILI.L (( >Filial("+57") ..nd.D
+57BC57:!R/)UT/ (( +56BC56:!R/)UT/ )
d<+elect.rea("+58")
d<+et/rder(8)
d<+ee=(>Filial("+58")?+57BC57:9/)9/M!)
o+ection'!rintLine()
o+ection'9ell("56:!R/)UT/")'7ide()
o+ection'9ell("58:)*+9")'7ide()
o+ection'9ell("56:6*R.!4")'7ide()
o+ection'9ell("56:6*R./!")'7ide()
o+ection'9ell("56:6*R./!I")'7ide()
o+ection'9ell("56:6*R.*M!")'7ide()
d<+elect.rea("+57")
d<+=ip()
*nd
)<+elect.rea("+56")
)<+=ip()
o+ection'Finish()
oReport'+=ipLine()
oReport'IncMeter()
*nd
Return
TReport sem usar mtodo TRSection:Print com sees
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse() //verifica se relatorios personaliaveis esta disponivel
!er"unte("MTR#$%"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection8
Local o+ection$
oReport '( TReport()',e-("M.TR#$%"&"Relacao das +u"estoes de /rca0entos"&"MTR#$%"&12oReport2
!rintReport(oReport)3&"*ste relatorio ira i0pri0ir a relacao das +u"estoes de 4enda confor0e os para0etros
solicitados.")
o+ection8 '( TR+ection()',e-(oReport&"!rodutos"&1"+56"&"+58"3)
TR9ell()',e-(o+ection8&"56:!R/)UT/"&"+56")
TR9ell()',e-(o+ection8&"58:)*+9"&"+58")
TR9ell()',e-(o+ection8&"56:6*R.!4"&"+56")
TR9ell()',e-(o+ection8&"56:6*R./!"&"+56")
TR9ell()',e-(o+ection8&"56:6*R./!I"&"+56")
TR9ell()',e-(o+ection8&"56:6*R.*M!"&"+56")
TR!osition(o+ection8&"+58"&8&122 >Filial("+58") ? +56BC56:!R/)UT/3)
o+ection$ '( TR+ection()',e-(o+ection8&"9o0ponentes"&1"+57"&"+58"3)
TR9ell()',e-(o+ection$&"57:+*;U*,9"&"+57")
TR9ell()',e-(o+ection$&"57:9/)9/M!"&"+57")
TR9ell()',e-(o+ection$&"58:)*+9"&"+58")
TR9ell()',e-(o+ection$&"57:;U.,T"&"+57")
TR!osition(o+ection$&"+58"&8&122 >Filial("+58") ? +57BC57:9/)9/M!3)
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection8 '( oReport'+ection(8)
Local o+ection$ '( oReport'+ection(8)'+ection(8)
)<+elect.rea("+56")
)<+et/rder(8)
)<+ee=(>Filial()?M4:!.R#8&.T.)
oReport'+etMeter(Rec9ount())
@hile ( A*of() ..nd. >Filial("+56") (( +56BC56:FILI.L ..nd. D
+56BC56:!R/)UT/ C( M4:!.R#8 ..nd. D
+56BC56:!R/)UT/ E( M4:!.R#$ )
If oReport'9ancel()
*>it
*ndIf
o+ection8'Init()
o+ection8'!rintLine()
d<+elect.rea("+57")
d<+et/rder(8)
d<+ee=(>Filial("+57")?+56BC56:!R/)UT/&.T.)
o+ection$'Init()
@hile ( A*of() ..nd. +57BC57:FILI.L (( >Filial("+57") ..nd.D
+57BC57:!R/)UT/ (( +56BC56:!R/)UT/ )
o+ection$'!rintLine()
d<+elect.rea("+57")
d<+=ip()
*nd
o+ection$'Finish()
)<+elect.rea("+56")
)<+=ip()
o+ection8'Finish()
oReport'IncMeter()
*nd
Return
TReport usando mtodo TRSection:Print com 1 seo
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse()
!er"unte("MTR%F#"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection
Local o5rea=
oReport '( TReport()',e-("MGR*!/RT"&"Relatorio de 4isitas"&"MTR%F#"&12oReport2 !rintReport(oReport)3&"Relatorio
de visitas de vendedores nos clientes")
o+ection '( TR+ection()',e-(oReport&"9lientes"&1"+.8"&"+.F"3)
TR9ell()',e-(o+ection&".8:4*,)"&"+.8")
TR9ell()',e-(o+ection&".F:,/M*"&"+.F")
TR9ell()',e-(o+ection&".8:9/)"&"+.8"&"9liente")
TR9ell()',e-(o+ection&".8:L/H."&"+.8")
TR9ell()',e-(o+ection&".8:,/M*"&"+.8")
TR9ell()',e-(o+ection&".8:ULT4I+"&"+.8")
TR9ell()',e-(o+ection&".8:T*M4I+"&"+.8")
TR9ell()',e-(o+ection&".8:9/,T.T/"&"+.8")
TR9ell()',e-(o+ection&".8:T*L"&"+.8")
o5rea= '( TR5rea=()',e-(o+ection&o+ection'9ell(".8:4*,)")&"+u< Total 4endedores")
TRFunction()',e-(o+ection'9ell(".8:9/)")&,IL&"9/U,T"&o5rea=)
TRFunction()',e-(o+ection'9ell(".8:T*M4I+")&,IL&"+UM"&o5rea=)
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection '( oReport'+ection(8)
Local c!art
Local cFiltro '( ""
#IF)*F T/!
//Transfor0a para0etros do tipo Ran"e e0 e>pressao +;L para ser utiliada na Iuery
Ma=e+Il*>pr("MTR%F#")
o+ection'5e"in;uery()
If ( 0v:par#F (( 8 )
c!art '( "J.,) (" ? )tos(d)ata5ase) ? " B .8:ULT4I+) C .8:T*M4I+J"
*lse
c!art '( "JJ"
*ndIf
5e"in+Il alias ";RG+.8"
+*L*9T .8:9/)&.8:L/H.&.8:,/M*&.8:4*,)&.8:ULT4I+&.8:T*M4I+&.8:T*L&.8:9/,T.T/&.F:,/M*
FR/M Jta<le'+.8J +.8&Jta<le'+.FJ +.F
@7*R* .8:4*,) ( .F:9/) .,) .8:FILI.L ( J>filial'+.8J .,)
.8:T*M4I+ C # .,) +.8.Jnot)elJ Je>p'c!artJ
/R)*R 5G .8:4*,)
*nd+Il
/K
!repara relatorio para e>ecutar a Iuery "erada pelo *0<edded +;L passando co0o
para0etro a per"unta ou vetor co0 per"untas do tipo Ran"e Iue fora0 alterados
pela funcao Ma=e+Il*>pr para sere0 adicionados a Iuery
K/
o+ection'*nd;uery(0v:par#L)
#*L+*
//Transfor0a para0etros do tipo Ran"e e0 e>pressao .)4!L para ser utiliada no filtro
Ma=e.dvpl*>pr("MTR%F#")
//.diciona no filtro o para0etro tipo Ran"e
If A*0pty(0v:par#L)
cFiltro ?( 0v:par#L ? " ..,). "
*ndIf
cFiltro ?( " .8:T*M4I+ C # "
If ( 0v:par#F (( 8 )
cFiltro ?( M ..,). (M?)to9(d)ata5ase)?MB.8:ULT4I+) C .8:T*M4I+M
*ndIf
o+ection'+etFilter(cFiltro&".8:4*,)")
TR!osition()',e-(oReport'+ection(8)&"+.F"&8&122 >Filial() ? +.8BC.8:4*,)3)
#*,)IF
o+ection'!rint()
Return
TReport usando mtodo TRSection:SetParentQuery
Para utiliar o e5emplo abai5o 3erifique se o seu reposit!rio est com Release < do Prot#eus
#include "protheus.ch"
User Function MyReport()
Local oReport
If TRepInUse()
!er"unte("MTR%F#"&.F.)
oReport '( Report)ef()
oReport'!rint)ialo"()
*ndIf
Return
+tatic Function Report)ef()
Local oReport
Local o+ection8
Local o+ection$
oReport '( TReport()',e-("MGR*!/RT"&"Relatorio de 4isitas"&"MTR%F#"&12oReport2 !rintReport(oReport)3&"Relatorio
de visitas de vendedores nos clientes")
o+ection8 '( TR+ection()',e-(oReport&"4endedores"&"+.F")
TR9ell()',e-(o+ection8&".F:9/)"&"+.F"&"4endedor")
TR9ell()',e-(o+ection8&".F:,/M*"&"+.F")
TRFunction()',e-(o+ection8'9ell(".F:9/)")&,IL&"9/U,T"&,IL&,IL&,IL&,IL&.F.)
o+ection$ '( TR+ection()',e-(o+ection8&"9lientes"&"+.8")
TR9ell()',e-(o+ection$&".8:9/)"&"+.8"&"9liente")
TR9ell()',e-(o+ection$&".8:L/H."&"+.8")
TR9ell()',e-(o+ection$&".8:,/M*"&"+.8")
TR9ell()',e-(o+ection$&".8:ULT4I+"&"+.8")
TR9ell()',e-(o+ection$&".8:T*M4I+"&"+.8")
TR9ell()',e-(o+ection$&".8:9/,T.T/"&"+.8")
TR9ell()',e-(o+ection$&".8:T*L"&"+.8")
TRFunction()',e-(o+ection$'9ell(".8:9/)")&,IL&"9/U,T")
TRFunction()',e-(o+ection$'9ell(".8:T*M4I+")&,IL&"+UM")
Return oReport
+tatic Function !rintReport(oReport)
Local o+ection8 '( oReport'+ection(8)
Local o+ection$ '( oReport'+ection(8)'+ection(8)
Local cFiltro '( ""
#IF)*F T/!
o+ection8'5e"in;uery()
If ( 0v:par#F (( 8 )
c!art '( "J.,) (" ? )tos(d)ata5ase) ? " B .8:ULT4I+) C .8:T*M4I+J"
*lse
c!art '( "JJ"
*ndIf
5e"in+Il alias ";RG+.F"
+*L*9T .8:9/)&.8:L/H.&.8:,/M*&.8:4*,)&.8:ULT4I+&.8:T*M4I+&.8:T*L&.8:9/,T.T/&.F:,/M*&.F:9/)
FR/M Jta<le'+.8J +.8&Jta<le'+.FJ +.F
@7*R* .8:4*,) ( .F:9/) .,) .8:FILI.L ( J>filial'+.8J .,)
.8:T*M4I+ C # .,) +.8.Jnot)elJ
/R)*R 5G .8:4*,)
*nd+Il
/K
!repara relatorio para e>ecutar a Iuery "erada pelo *0<edded +;L passando co0o
para0etro a per"unta ou vetor co0 per"untas do tipo Ran"e Iue fora0 alterados
pela funcao Ma=e+Il*>pr para sere0 adicionados a Iuery
K/
o+ection8'*nd;uery(0v:par#L)
o+ection$'+et!arent;uery()
o+ection$'+et!arentFilter(12c!ara02 ;RG+.FBC.8:4*,) C( c!ara0 .and. ;RG+.FBC.8:4*,) E( c!ara03&122
;RG+.FBC.F:9/)3)
#*L+*
cFiltro '( " .8:T*M4I+ C # "
If ( 0v:par#F (( 8 )
cFiltro ?( M ..,). (M?)to9(d)ata5ase)?MB.8:ULT4I+) C .8:T*M4I+M
*ndIf
o+ection$'+etFilter(cFiltro&".8:4*,)")
o+ection$'+etRelation(122 +.FBC.F:9/)3)
o+ection$'+et!arentFilter(12c!ara02 +.8BC.8:4*,) C( c!ara0 .and. +.8BC.8:4*,) E( c!ara03&122 +.FB
C.F:9/)3)
#*,)IF
o+ection8'!rint()
Return
TRSection
Descrio
Seo de um relat!rio que utilia a classe TReport.
A classe TRSection pode ser entendida como um la?out do relat!rio, por conter c%lulas, quebras e
totaliadores que daro um formato para sua impresso.
Com a classe TRSection % poss03el definir uma quer?, filtro ou 0ndice com filtro "6ndRe2ua$ que ser
utiliada por ela para processamento do relat!rio, atra3%s do m%todo Print e utiliando as c%lulas de
posicionamento "TRPosition$ e componente de posicionamento de seo "TRPosSection$, sem a
necessidade de escre3er um fonte para processar os resultados da quer?, filtro ou 0ndice com filtro.
Mtodos
Mtodo Descrio
New
1%todo construtor da classe TRSection
7o parametro onde % informado as tabelas utiliadas pela seo, a primeira ser
a principal, sendo utiliada para o processamento pelo m%todo Print. As outras
tabelas sero utiliadas para que o usurio possa incluir os campos como c%lula.
( relacionamento entre as tabelas poder ser feito pela quer? ou ento pelo uso
dos ob>etos da classe TRPosition.
Dos elementos do parametro onde so informadas as ordens utiliada pela
seo sero criados os ob>etos da classe TR(rder automaticamente, utiliando
como 0ndice da tabela principal a ordem do elemento no 3etor.
Parent Retorna o ob>eto pai da classe TRSection
Report Retorna o ob>eto da classe TReport que a classe TRSection pertence
Page(rea% Retorna se salta a p2ina na quebra de seo
!eader(rea% Retorna se cabeal#o das c%lulas ser impresso ap!s uma quebra "TR-rea.$
!eaderSection Retorna se cabeal#o das c%lulas ser impresso na quebra de seo
)isi*le Retorna se o componente esta #abilitada para impresso
Alias
Retorna o alias utiliado pela quer? da seo, que foi definida pelo &mbedded
SI@ com os m%todos -e2inIuer? e &ndIuer?
S"ow Mabilita a impresso do componente
!ide
Desabilita a impresso da seo, por%m todas as lin#as sero processadas,
somente no aparecero no relat!rio.
lRead$nl' Retorna se o usurio pode alterar o la?out da seo
Init
6nicialia seo.
7o % necessrio e5ecutar o m%todo 6nit se for utiliar o m%todo Print, > que
este fa o controle de inicialiao e finaliao das sees.
Caso no este>a utiliando o m%todo Print, sempre e5ecute o m%todo 6nit para
inicialiar a seo, para controle de quebra de p2ina entre sees, impresso
do cabeal#o das c%lulas e para outros tratamentos internos do componente.
Finis" /inalia seo inicialiada pelo m%todo 6nit.
7o % necessrio e5ecutar o m%todo /inis# se for utiliar o m%todo Print, > que
este fa o controle de inicialiao e finaliao das sees.
Caso no este>a utiliando o m%todo Print, sempre e5ecute o m%todo /inis# ao
finaliar uma seo, para controle da impresso dos totaliadores das quebras e
dos que esto #abilitados para o final da seo, para controle de quebra de
p2ina entre sees e para outros tratamentos internos do componente.
Printine 6mprime a lin#a baseado nas c%lulas selecionadas pelo usurio
Print
Processa as informaes da tabela principal ou da quer? definida pelo &mbedded
SI@ com os m%todos -e2inIuer? e &ndIuer?
( m%todo Print fa o loop na tabela ou na quer?, e5ecutando o m%todo Print@ine
para cada lin#a e o m%todo Print de todas as sees fil#as. 7as sees fil#as, o
posicionamento inicial pode ser baseado na quer? da seo pai "atra3%s do
m%todo SetParentIuer?$ ou atra3%s da re2ra informada pelo m%todo
SetRelation, >unto com a re2ra informada pelo m%todo SetParent/ilter que
controla a sa0da do loop.
Cell Retorna ob>eto da classe TRCell "c%lula$ baseado no parametro informado.
$rder Retorna ob>eto da classe TR(rder "ordem$ basead no parametro informado
oadCells
Carre2a campos do Dicionrio de Campos "SLO$ como c%lulas da seo,
respeitando n03el, uso e conte5to do campo
oad$rder Carre2a 0ndices do Dicionrio de Jndices "S6L$ como ordem da seo
SetPage(rea% Define se salta a p2ina na quebra de seo
Set!eader(rea% Define se imprime cabeal#o das c%lulas ap!s uma quebra "TR-rea.$
Set!eaderSection Define de imprime cabeal#o das c%lulas na quebra de seo
SetRead$nl'
Define se o usurio no poder alterar o la?out da seo, ou se>a, no poder
remo3er as c%lulas pr%,definidas.
As c%lulas que forem adicionadas na seo sero impressas na pr!5ima p2ina,
ap!s ter impresso as c%lulas pr%,definidas.
Get+&er'
Retorna a quer? que foi definida pelo &mbedded SI@ com os m%todos
-e2inIuer? e &ndIuer?, > com as c%lulas selecionadas e filtro criado pelo
usurio e as per2untas tipo Ran2e incluidas.
(egin+&er'
6ndica que ser utiliado o &mbedded SI@ para criao de uma no3a quer? que
ser utiliada pela seo
End+&er'
6ndica a quer? criada utiliando o &mbedded SI@ para a seo.
( m%todo &ndIuer? ira >untar na quer? as c%lulas selecionadas e o filtro criado
pelo usurio, mais a e5presso das per2untas do tipo Ran2e, que foram
con3ertidas anteriormente pela funo 1a.eSI@&5pr.
Ap!s sua e5ecuo a quer? esta pronta para ser utiliada tanto pela classe
TRSection como para o fonte que esta criando os componentes, sem a
necessidade de utiliar TCHenIuer?, C#an2eIuer? e TCSet/ield.
SetParent+&er'
Define se a seo fil#a utiliara a quer? da seo pai no processamento do
m%todo Print
SetParentFilter
Define a re2ra de sa0da do loop de processamento do m%todo Print das sees
fil#as
SetFilter
Define um filtro ou um 0ndice com filtro "6ndRe2ua$ para a tabela princiapal da
seo.
Se no informado o parametro com a c#a3e de 0ndice, ser e5ecutado S&T
/6@T&R T( com o primeiro parametro, seno ser criado um 0ndice com filtro
"6ndRe2ua$ e sua ordem ser retornada pelo m%todo Het6d5(rder
Set$rder Define a ordem "TR(rder$ que ser utiliada pela seo
SetIdx$rder Define uma ordem de 0ndice para a tabela principal
Get$rder Retorna a ordem selecionada pelo usurio
GetIdx$rder
Retorna o 0ndice utiliado pela tabela principal da seo para processamento
pelo m%todo Print.
Se o retorno for ero, ento a seo esta utiliando uma ordem selecionada pelo
usurio "TR(rder$
SetRelation
Define a f!rmula de relacionamento de uma seo fil#a com sua seo pai, caso
no utilie a quer? da seo pai "SetParentIuer?$
( m%todo SetRelation ir criar o componente TRRelation apresentado no
documento 9&strutura do componente TReport9, que fa o controle do
relacionamento entre as sees.
'lias
Sintaxe
o(b>'Alias " $ ,,A cAlias
Retorno
Tipo Descrio
Caracter Alias utiliado pela quer?
Descrio
Retorna o alias utiliado pela quer? da seo, que foi definida pelo &mbedded SI@ com os m%todos
-e2inIuer? e &ndIuer?
Be$inQuery
Sintaxe
o(b>'-e2inIuer? " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6ndica que ser utiliado o &mbedded SI@ para criao de uma no3a quer? que ser utiliada pela seo
ell
Sintaxe
o(b>'Cell " B uCell A $ ,,A oCell
Parmetros
Argumento Tipo Descrio
uCell "Iualquer$
Tipo Caracter' 7ome ou t0tulo do ob>eto
Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos
componentes TRCell
Retorno
Tipo Descrio
(b>eto
(b>eto da classe TRCell.
Se no for encontrado o ob>eto se2undo o parametro informado ser retornado 7ulo
Descrio
Retorna ob>eto da classe TRCell "c%lula$ baseado no parametro informado.
#ndQuery
Sintaxe
o(b>'&ndIuer? " C uParam D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
uParam "Iualquer$
Per2unta "e5emplo' m3Ppar:)$ ou
lista de per2untas "e5emplo' Fm3Ppar:), m3Ppar:KG$ do tipo Ran2e
que sero incluidas na quer?
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6ndica a quer? criada utiliando o &mbedded SI@ para a seo.
( m%todo &ndIuer? ira >untar na quer? as c%lulas selecionadas e o filtro criado pelo usurio, mais a
e5presso das per2untas do tipo Ran2e, que foram con3ertidas anteriormente pela funo 1a.eSI@&5pr.
Ap!s sua e5ecuo a quer? esta pronta para ser utiliada tanto pela classe TRSection como para o fonte
que esta criando os componentes, sem a necessidade de utiliar TCHenIuer?, C#an2eIuer? e TCSet/ield.
Finis&
Sintaxe
o(b>'/inis# " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
/inalia seo inicialiada pelo m%todo 6nit.
7o % necessrio e5ecutar o m%todo /inis# se for utiliar o m%todo Print, > que este fa o controle de
inicialiao e finaliao das sees.
Caso no este>a utiliando o m%todo Print, sempre e5ecute o m%todo /inis# ao finaliar uma seo, para
controle da impresso dos totaliadores das quebras e dos que esto #abilitados para o final da seo,
para controle de quebra de p2ina entre sees e para outros tratamentos internos do componente.
(et*dx)rder
Sintaxe
o(b>'Het6d5(rder " $ ,,A n6d5(rder
Retorno
Tipo Descrio
7um%rico Jndice utiliado
Descrio
Retorna o 0ndice utiliado pela tabela principal da seo para processamento pelo m%todo Print.
Se o retorno for ero, ento a seo esta utiliando uma ordem selecionada pelo usurio "TR(rder$
(et)rder
Sintaxe
o(b>'Het(rder " $ ,,A n(rder
Retorno
Tipo Descrio
7um%rico (rdem selecionada pelo usurio
Descrio
Retorna a ordem selecionada pelo usurio
(etQuery
Sintaxe
o(b>'HetIuer? " $ ,,A cIuer?
Retorno
Tipo Descrio
Caracter Iuer? utiliada pela seo
Descrio
Retorna a quer? que foi definida pelo &mbedded SI@ com os m%todos -e2inIuer? e &ndIuer?, > com as
c%lulas selecionadas e filtro criado pelo usurio e as per2untas tipo Ran2e incluidas.
,eaderBrea/
Sintaxe
o(b>'Meader-rea. " $ ,,A lMeader-rea.
Retorno
Tipo Descrio
@!2ico Eerdadeiro se imprime cabeal#o
Descrio
Retorna se cabeal#o das c%lulas ser impresso ap!s uma quebra "TR-rea.$
,eaderSection
Sintaxe
o(b>'MeaderSection " $ ,,A lMeaderSection
Retorno
Tipo Descrio
@!2ico Eerdadeiro se imprime cabeal#o
Descrio
Retorna se cabeal#o das c%lulas ser impresso na quebra de seo
,ide
Sintaxe
o(b>'Mide " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desabilita a impresso da seo, por%m todas as lin#as sero processadas, somente no aparecero no
relat!rio.
*nit
Sintaxe
o(b>'6nit " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6nicialia seo.
7o % necessrio e5ecutar o m%todo 6nit se for utiliar o m%todo Print, > que este fa o controle de
inicialiao e finaliao das sees.
Caso no este>a utiliando o m%todo Print, sempre e5ecute o m%todo 6nit para inicialiar a seo,
para controle de quebra de p2ina entre sees, impresso do cabeal#o das c%lulas e para outros
tratamentos internos do componente.
%oadells
Sintaxe
o(b>'@oadCells " C cTable D , C aCells D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cTable Caracter
Tabela que ser utiliada para carre2ar os campos. Se no for informada
ser utiliado todas as tabelas informadas no m%todo 7e4 da classe
TRSection.
aCells Arra?
Eetor com nome dos campos que sero carre2ados como c%lulas da
seo
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Carre2a campos do Dicionrio de Campos "SLO$ como c%lulas da seo, respeitando n03el, uso e conte5to
do campo
%oad)rder
Sintaxe
o(b>'@oad(rder " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Carre2a 0ndices do Dicionrio de Jndices "S6L$ como ordem da seo
!e+
Sintaxe
TRSection"$'7e4 " B oParent A , C cTitle D , C uTable D , C a(rder D , C l@oadCells D , C l@oad(rder D $ ,,A
TRSection
Parmetros
Argumento Tipo Descrio
oParent (b>eto
(b>eto da classe TReport ou TRSection que ser o pai da classe
TRSection
cTitle Caracter T0tulo da seo
uTable "Iualquer$ Tabela ou lista de tabelas que sero utiliadas pela seo
a(rder Arra? Eetor com a descrio das ordens
l@oadCells @!2ico
Eerdadeiro para carre2ar os campos do Dicionrio de Campos "SLO$ das
tabelas da seo como c%lulas
Ealor padro' /also
l@oad(rder @!2ico
Eerdadeiro para carre2ar os 0ndices do Dicionrio de Jndices "S6L$
Ealor padro' /also
Retorno
Tipo Descrio
(b>eto (b>eto da classe TRSection
Descrio
1%todo construtor da classe TRSection
7o parametro onde % informado as tabelas utiliadas pela seo, a primeira ser a principal, sendo
utiliada para o processamento pelo m%todo Print. As outras tabelas sero utiliadas para que o usurio
possa incluir os campos como c%lula.
( relacionamento entre as tabelas poder ser feito pela quer? ou ento pelo uso dos ob>etos da classe
TRPosition.
Dos elementos do parametro onde so informadas as ordens utiliada pela seo sero criados os ob>etos
da classe TR(rder automaticamente, utiliando como 0ndice da tabela principal a ordem do elemento no
3etor.
)rder
Sintaxe
o(b>'(rder " B u(rder A $ ,,A o(rder
Parmetros
Argumento Tipo Descrio
u(rder "Iualquer$
Tipo Caracter' 7ic.name da ordem
Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos
componentes TR(rder
Retorno
Tipo Descrio
(b>eto (b>eto da classe TR(rder
Descrio
Retorna ob>eto da classe TR(rder "ordem$ basead no parametro informado
Pa$eBrea/
Sintaxe
o(b>'Pa2e-rea. " $ ,,A lPa2e-rea.
Retorno
Tipo Descrio
@!2ico Eerdadeiro se quebra a p2ina
Descrio
Retorna se salta a p2ina na quebra de seo
Parent
Sintaxe
o(b>'Parent " $ ,,A oParent
Retorno
Tipo Descrio
(b>eto (b>eto da classe TReport ou TRSection
Descrio
Retorna o ob>eto pai da classe TRSection
Print
Sintaxe
o(b>'Print " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Processa as informaes da tabela principal ou da quer? definida pelo &mbedded SI@ com os m%todos
-e2inIuer? e &ndIuer?
( m%todo Print fa o loop na tabela ou na quer?, e5ecutando o m%todo Print@ine para cada lin#a e o
m%todo Print de todas as sees fil#as. 7as sees fil#as, o posicionamento inicial pode ser baseado na
quer? da seo pai "atra3%s do m%todo SetParentIuer?$ ou atra3%s da re2ra informada pelo m%todo
SetRelation, >unto com a re2ra informada pelo m%todo SetParent/ilter que controla a sa0da do loop.
Print%ine
Sintaxe
o(b>'Print@ine " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
6mprime a lin#a baseado nas c%lulas selecionadas pelo usurio
Report
Sintaxe
o(b>'Report " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna o ob>eto da classe TReport que a classe TRSection pertence
SetFilter
Sintaxe
o(b>'Set/ilter " B c/ilter A , C c6nde5Qe? D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
c/ilter Caracter &5presso de filtro no formato ADEP@
c6nde5Qe? Caracter C#a3e de 0ndice
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define um filtro ou um 0ndice com filtro "6ndRe2ua$ para a tabela princiapal da seo.
Se no informado o parametro com a c#a3e de 0ndice, ser e5ecutado S&T /6@T&R T( com o primeiro
parametro, seno ser criado um 0ndice com filtro "6ndRe2ua$ e sua ordem ser retornada pelo m%todo
Het6d5(rder
Set,eaderBrea/
Sintaxe
o(b>'SetMeader-rea. " C lMeader-rea. D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lMeader-rea. @!2ico
Eerdadeiro para imprimir o cabeal#o
Ealor padro' 3erdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se imprime cabeal#o das c%lulas ap!s uma quebra "TR-rea.$
Set,eaderSection
Sintaxe
o(b>'SetMeaderSection " C lMeaderSection D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lMeaderSection @!2ico
Eerdadeiro para imprimir o cabeal#o
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define de imprime cabeal#o das c%lulas na quebra de seo
Set*dx)rder
Sintaxe
o(b>'Set6d5(rder " B n6d5(rder A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n6d5(rder 7um%rico (rdem do 0ndice
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define uma ordem de 0ndice para a tabela principal
Set)rder
Sintaxe
o(b>'Set(rder " B n(rdem A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n(rdem 7um%rico (rdem que ser utiliada
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a ordem "TR(rder$ que ser utiliada pela seo
SetPa$eBrea/
Sintaxe
o(b>'SetPa2e-rea. " C lPa2e-rea. D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lPa2e-rea. @!2ico
Eerdadeiro para saltar a p2ina
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se salta a p2ina na quebra de seo
SetParentFilter
Sintaxe
o(b>'SetParent/ilter " B b/ilter A , C bParam D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
b/ilter Code,-loc. -loco de c!di2o com a re2ra para sa0da do loop
bParam Code,-loc.
-loco de c!di2o com a e5presso que retornar o 3alor que ser
en3iado como parametro para o parametro com a re2ra para sa0da do
loop
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a re2ra de sa0da do loop de processamento do m%todo Print das sees fil#as
SetParentQuery
Sintaxe
o(b>'SetParentIuer? " C lParentIuer? D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
lParentIuer? @!2ico
Eerdadeiro para utiliar quer? da seo pai
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se a seo fil#a utiliara a quer? da seo pai no processamento do m%todo Print
SetRead)nly
Sintaxe
o(b>'SetRead(nl? " C SetRead(nl? D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
SetRead(nl? @!2ico
Eerdadeiro para desabilitar alterao do la?out
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se o usurio no poder alterar o la?out da seo, ou se>a, no poder remo3er as c%lulas pr%,
definidas.
As c%lulas que forem adicionadas na seo sero impressas na pr!5ima p2ina, ap!s ter impresso as
c%lulas pr%,definidas.
SetRelation
Sintaxe
o(b>'SetRelation " B b/ormula A , C cAlias D , C u(rder D , C lSee. D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
b/ormula Code,-loc. -loco de c!di2o com a e5presso para relacionamento entre as sees
cAlias Caracter Tabela utiliada pela f!rmula
u(rder "Iualquer$
(rdem utiliada tabela
Tipo Caracter' 7ic.name da ordem de 0ndice
Tipo 7um%rico' (rdem do 0ndice
lSee. @!2ico
6ndica se ser e5ecutado DbSee. com o conte=do da f!rmula
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a f!rmula de relacionamento de uma seo fil#a com sua seo pai, caso no utilie a quer? da
seo pai "SetParentIuer?$
( m%todo SetRelation ir criar o componente TRRelation apresentado no documento 9&strutura do
componente TReport9, que fa o controle do relacionamento entre as sees.
S&o+
Sintaxe
o(b>'S#o4 " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Mabilita a impresso do componente
2isi3le
Sintaxe
o(b>'Eisible " $ ,,A lEisible
Retorno
Tipo Descrio
@!2ico Eerdadeiro se esta #abilitado a impresso
Descrio
Retorna se o componente esta #abilitada para impresso
lRead)nly
Sintaxe
o(b>'lRead(nl? " $ ,,A lRead(nl?
Retorno
Tipo Descrio
@!2ico Eerdadeiro se usurio no pode alterar o la?out
Descrio
Retorna se o usurio pode alterar o la?out da seo
TRBrea/
Descrio
Iuebra de uma seo de um relat!rio que utilia a classe TReport.
A classe TR-rea. % utiliada para impresso dos totaliadores da seo antes do final da mesma ou do
relat!rio, dependendo da re2ra de quebra informada.
Mtodos
Mtodo Descrio
New 1%todo construtor da classe TR-rea.
Set(rea% Define a re2ra para a quebra
Exec&te
&5ecuta a re2ra e indica se #ou3e a quebra.
( m%todo &5ecute % e5ecutado para cada lin#a impressa pelo m%todo Print@ine
da seo que a quebra pertence.
#xecute
Sintaxe
o(b>'&5ecute " $ ,,A l-rea.
Retorno
Tipo Descrio
@!2ico 6ndique que #ou3e uma quebra
Descrio
&5ecuta a re2ra e indica se #ou3e a quebra.
( m%todo &5ecute % e5ecutado para cada lin#a impressa pelo m%todo Print@ine da seo que a quebra
pertence.
!e+
Sintaxe
TR-rea."$'7e4 " B oParent A , C u-rea. D , C cTitle D , C lTotal6n@ine D $ ,,A TR-rea.
Parmetros
Argumento Tipo Descrio
oParent (b>eto (b>eto da classe TRSection que a quebra pertence
u-rea. "Iualquer$ Re2ra para quebra
Tipo (b>eto' (b>eto da classe TRCell
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de c!di2o com e5presso que ser
e5ecutada
cTitle Caracter T0tulo da quebra
lTotal6n@ine @!2ico
Eerdadeiro se totaliadores sero impressos em lin#a
Ealor padro' /also
Retorno
Tipo Descrio
(b>eto (b>eto da classe TR-rea.
Descrio
1%todo construtor da classe TR-rea.
SetBrea/
Sintaxe
o(b>'Set-rea. " B u-rea. A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
u-rea. "Iualquer$
Re2ra para quebra
Tipo (b>eto' (b>eto da classe TRCell
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de c!di2o com e5presso que ser
e5ecutada
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a re2ra para a quebra
TRell
Descrio
C%lula de impresso de uma seo "TRSection$ de um relat!rio que utilia a classe TReport
Mtodos
Mtodo Descrio
New
1%todo construto da classe TRCell.
Se o nome da c%lula informada pelo parametro for encontrado no Dicionrio de
Campos "SLO$, as informaes do campo sero carre2adas para a c%lula,
respeitando os parametros de t0tulo, picture e taman#o. Dessa forma o relat!rio
sempre estar atualiado com as informaes do Dicionrio de Campos "SLO$.
( nome da c%lula ser utiliado >unto ao alias informado pelo parametro como
conte=do para a impresso da c%lula, como por e5emplo a impresso do campo
A)PC(D da tabela SA).
Se for informado o parametro com o bloco de c!di2o, o retorno deste ser
utiliado como conte=do para impresso da c%lula, com a picture, taman#o e
t0tulo definidos para a c%lula. Assim sendo % poss03el criar c%lulas calculadas
com formato de impresso baseada no Dicionrio de Campos "SLO$
Ena*le Mabilita impresso da c%lula
Disa*le
Desabilita impresso da c%lula, ou se>a, a c%lula no ser impressa e seu
poscionamento no ser calculado
!ide Desabilita impresso da c%lula, por%m continua calculando seu poscionamento
ColPos
Retorna a coluna que a c%lula ser impressa pelo m%todo Print@ine da seo que
a c%lula pertence
Exec&te
A3alia as informaes da c%lula para a impresso do conte=do pelo m%todo
Print@ine da seo que a c%lula pertente
Get#idt" Retorna a lar2ura da c%lula
GetText
Retorna o te5to que ser impresso pelo m%todo Print@ine da seo que a c%lula
pertence
GetFieldIn,o
Carre2a informaes "t0tulo, picture, taman#o, etc$ do campo informado pelo
parametro baseado no Dicionrio de Campos "SLO$
SetPict&re Define a mscara de impresso da c%lula
SetSi-e Define o taman#o da c%lula, em pi5el ou n=mero de caracteres
Set(loc%
Define o bloco de c!di2o que retornar o conte=do de impresso da c%lula.
Definindo o bloco de c!di2o para a c%lula, esta no utiliara mais o nome mais o
alias para retornar o conte=do de impresso.
Set)al&e
Define um 3alor constante para a c%lula.
Definindo um 3alor constante para a c%lula, esta no utiliara o nome mais o
alias para impresso do conte=do, ou se>a, a c%lula passar a se comportar
como um 3ria3el de um pro2rama.
Se o parametro no for informado "7ulo$, ento a c%lula dei5ar de usar o 3alor
constante, 3oltando a imprimir seu conte=do utiliando nome mais alias.
SetAlign Define o alin#amento da c%lula na impresso.
( alin#amento padro sem o uso do m%todo SetAli2n depende do tipo do
conte=do da c%lula no momento da impresso'
Tipo num%rico' alin#amento a direita
(utros tipos' alin#amento a esquerda
SetC(ox
Define que a c%lula ir imprimir a descrio do item de um campo que ten#a o
formato Combo-o5, utiliado no Dicionrio de Campos "SLO$
( formato do parametro % o mesmo utiliado no Dicionrio de Campos "SLO$,
como no e5emplo abai5o'
oCell'SetC-o5"9)8Sim*K87o9$.
7a impresso ser utiliado a descrio do item. 7o e5emplo acima se o
conte=do da c%lula for 9)9, ser impresso 9Sim9, sendo que o m%todo > ira
calcular o taman#o da c%lula baseado na maior descrio informada.
Get)al&e Retorna o 3alor constante da c%lula definido pelo m%todo SetEalue
olPos
Sintaxe
o(b>'ColPos " $ ,,A nCol
Retorno
Tipo Descrio
7um%rico Coluna de impresso da c%lula
Descrio
Retorna a coluna que a c%lula ser impressa pelo m%todo Print@ine da seo que a c%lula pertence
"isa3le
Sintaxe
o(b>'Disable " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desabilita impresso da c%lula, ou se>a, a c%lula no ser impressa e seu poscionamento no ser
calculado
#na3le
Sintaxe
o(b>'&nable " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Mabilita impresso da c%lula
#xecute
Sintaxe
o(b>'&5ecute " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
A3alia as informaes da c%lula para a impresso do conte=do pelo m%todo Print@ine da seo que a
c%lula pertente
(etField*n1o
Sintaxe
o(b>'Het/ield6nfo " B c/ield A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
c/ield Caracter 7ome do campo
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Carre2a informaes "t0tulo, picture, taman#o, etc$ do campo informado pelo parametro baseado no
Dicionrio de Campos "SLO$
(etText
Sintaxe
o(b>'HetTe5t " $ ,,A cTe5t
Retorno
Tipo Descrio
Caracter Te5to para impresso
Descrio
Retorna o te5to que ser impresso pelo m%todo Print@ine da seo que a c%lula pertence
(et2alue
Sintaxe
o(b>'HetEalue " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna o 3alor constante da c%lula definido pelo m%todo SetEalue
(et-idt&
Sintaxe
o(b>'HetNidt# " $ ,,A nNidt#
Retorno
Tipo Descrio
7um%rico @ar2ura da c%lula
Descrio
Retorna a lar2ura da c%lula
,ide
Sintaxe
o(b>'Mide " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desabilita impresso da c%lula, por%m continua calculando seu poscionamento
!e+
Sintaxe
TRCell"$'7e4 " B oParent A , B c7ame A , C cAlias D , C cTitle D , C cPicture D , C nSie D , C lPi5el D ,
C b-loc. D $ ,,A TRCell
Parmetros
Argumento Tipo Descrio
oParent (b>eto (b>eto da classe TRSection que a c%lula pertence
c7ame Caracter 7ome da c%lula
cAlias Caracter Alias utiliado pela c%lula
cTitle Caracter T0tulo da c%lula
cPicture Caracter 1scara de impresso da c%lula
nSie 7um%rico Taman#o da c%lula, em pi5el ou n=mero de caracteres
lPi5el @!2ico 6ndica se taman#o esta sendo informado em pi5el
b-loc. Code,-loc. -loco de c!di2o que retornar o conte=do da c%lula
Retorno
Tipo Descrio
(b>eto (b>eto da classe TRCell
Descrio
1%todo construto da classe TRCell.
Se o nome da c%lula informada pelo parametro for encontrado no Dicionrio de Campos "SLO$, as
informaes do campo sero carre2adas para a c%lula, respeitando os parametros de t0tulo, picture e
taman#o. Dessa forma o relat!rio sempre estar atualiado com as informaes do Dicionrio de Campos
"SLO$.
( nome da c%lula ser utiliado >unto ao alias informado pelo parametro como conte=do para a impresso
da c%lula, como por e5emplo a impresso do campo A)PC(D da tabela SA).
Se for informado o parametro com o bloco de c!di2o, o retorno deste ser utiliado como conte=do para
impresso da c%lula, com a picture, taman#o e t0tulo definidos para a c%lula. Assim sendo % poss03el criar
c%lulas calculadas com formato de impresso baseada no Dicionrio de Campos "SLO$
Set'li$n
Sintaxe
o(b>'SetAli2n " B nAli2n A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nAli2n Caracter
Tipo de alin#amento
R@&/TR , esquerda
RR6HMR , direita
RC&7T&RR , centro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o alin#amento da c%lula na impresso.
( alin#amento padro sem o uso do m%todo SetAli2n depende do tipo do conte=do da c%lula no momento
da impresso'
Tipo num%rico' alin#amento a direita
(utros tipos' alin#amento a esquerda
SetBloc/
Sintaxe
o(b>'Set-loc. " B b-loc. A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
b-loc. Code,-loc. -loco de c!di2o com e5presso que retornar o conte=do de impresso
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o bloco de c!di2o que retornar o conte=do de impresso da c%lula.
Definindo o bloco de c!di2o para a c%lula, esta no utiliara mais o nome mais o alias para retornar o
conte=do de impresso.
SetBox
Sintaxe
o(b>'SetC-o5 " B cC-o5 A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cC-o5 Caracter Te5to com os itens e descrio do Combo-o5
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define que a c%lula ir imprimir a descrio do item de um campo que ten#a o formato Combo-o5,
utiliado no Dicionrio de Campos "SLO$
( formato do parametro % o mesmo utiliado no Dicionrio de Campos "SLO$, como no e5emplo abai5o'
oCell'SetC-o5"9)8Sim*K87o9$.
7a impresso ser utiliado a descrio do item. 7o e5emplo acima se o conte=do da c%lula for 9)9, ser
impresso 9Sim9, sendo que o m%todo > ira calcular o taman#o da c%lula baseado na maior descrio
informada.
SetPicture
Sintaxe
o(b>'SetPicture " B cPicture A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cPicture Caracter 1scara de impresso da c%lula, no formato ADEP@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a mscara de impresso da c%lula
SetSi0e
Sintaxe
o(b>'SetSie " B nSie A , C lPi5el D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
nSie 7um%rico Taman#o da c%lula
lPi5el @!2ico
6ndica se taman#o esta sendo informado em pi5el
Ealor padro' /also
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define o taman#o da c%lula, em pi5el ou n=mero de caracteres
Set2alue
Sintaxe
o(b>'SetEalue " C uParam D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
uParam "Iualquer$ Define 3alor constante para a c%lula
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define um 3alor constante para a c%lula.
Definindo um 3alor constante para a c%lula, esta no utiliara o nome mais o alias para impresso do
conte=do, ou se>a, a c%lula passar a se comportar como um 3ria3el de um pro2rama.
Se o parametro no for informado "7ulo$, ento a c%lula dei5ar de usar o 3alor constante, 3oltando a
imprimir seu conte=do utiliando nome mais alias.
TRFunction
Descrio
Totaliador de uma quebra, seo ou relat!rio que utilia a classe TReport.
+m totaliador pode e5ecutar uma das se2uintes funes abai5o, utiliando como referencia uma c%lula
da seo ou o retorno de uma f!rmula definida para ele'
S+1 "somar$
C(+7T "contar$
1AL "3alor m5imo$
167 "3alor m0nimo$
AE&RAH& "3alor m%dio$
7a criao do totaliador sempre % informado uma seo "TRSection$ a qual ele pertence, e
automaticamente o totaliador ser incluido no relat!rio "TReport$ que a seo pertence.
Mtodos
Mtodo Descrio
New
1%todo construtor da classe TR/unction.
( parametro que indica qual c%lula o totaliador se refere ,ser utiliado para
posicionamento de impresso do totaliador quando esti3er definido que a
impresso ser por coluna e como conte=do para a funo definida caso no
se>a informada uma f!rmula para o totaliador
Form&la Retorna a f!rmula do totaliador
Section)al&e Retorna o 3alor atual do totaliador para a seo
Page)al&e Retorna o 3alor atual do totaliador para a p2ina
Report)al&e Retorna o 3alor atual do totaliador para o relat!rio
GetF&nction
Retorna a funo "S+1, C(+7T, 1AL, 167, AE&RAH&$ utiliada pelo
totaliador.
EndSection Retorna se o totaliador ser impresso na quebra de seo
EndPage Retorna se totaliador ser impresso no final da p2ina
EndReport Retorna se totaliador ser impresso no final do relat!rio
Exec&te
&5ecuta a funo do totaliador, utiliando a f!rmula definida pelo m%todo 7e4
ou pelo m%todo Set/ormula.
( m%todo &5ecute % e5ecutado para cada lin#a impressa pelo m%todo Print@ine
da seo que o totaliador pertence.
Reset Reinicia 3alor do totaliador
ResetSection Reinicia 3alor do totaliador para a seo
ResetPage Reinicia 3alor do totaliador para a p2ina
ResetReport Reinicia 3alor do totaliador para o relat!rio
SetForm&la
Define a f!rmula utiliada pelo totaliador ao in3%s do conte=do da c%lula que
ele se refere
Set(rea% Define a quebra "TR-rea.$ que o totaliador ser impresso
SetF&nction
Define a funo "S+1, C(+7T, 1AL, 167, AE&RAH&, M(+R$ que ser utiliada
pelo totaliador
SetEndSection Define se o totaliador ser impresso na quebra de seo
SetEndPage Define se o totaliador ser impresso no final da p2ina
SetEndReport Define se o totaliador ser impresso no final do relat!rio
#ndPa$e
Sintaxe
o(b>'&ndPa2e " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna se totaliador ser impresso no final da p2ina
#ndReport
Sintaxe
o(b>'&ndReport " $ ,,A l&ndReport
Retorno
Tipo Descrio
@!2ico
Eerdadeiro para imprimir no final do relat!rio
Ealor padro' Eerdadeiro
Descrio
Retorna se totaliador ser impresso no final do relat!rio
#ndSection
Sintaxe
o(b>'&ndSection " $ ,,A l&ndSection
Retorno
Tipo Descrio
@!2ico Eerdadeiro se imprime na quebra de seo
Descrio
Retorna se o totaliador ser impresso na quebra de seo
#xecute
Sintaxe
o(b>'&5ecute " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
&5ecuta a funo do totaliador, utiliando a f!rmula definida pelo m%todo 7e4 ou pelo m%todo
Set/ormula.
( m%todo &5ecute % e5ecutado para cada lin#a impressa pelo m%todo Print@ine da seo que o totaliador
pertence.
Formula
Sintaxe
o(b>'/ormula " $ ,,A u/ormula
Retorno
Tipo Descrio
"Iualquer$
, (b>eto da classe TRCell ou *
, te5to para macro e5ecuo ou *
, bloco de c!di2o
Descrio
Retorna a f!rmula do totaliador
(etFunction
Sintaxe
o(b>'Het/unction " $ ,,A c/unction
Retorno
Tipo Descrio
Caracter /uno utiliada pelo totaliador
Descrio
Retorna a funo "S+1, C(+7T, 1AL, 167, AE&RAH&$ utiliada pelo totaliador.
!e+
Sintaxe
TR/unction"$'7e4 " B oParent A , C c6D D , B c/unction A , C o-rea. D , C cTitle D , C cPicture D , C u/ormula
D , C l&ndSection D , C l&ndReport D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
oParent (b>eto (b>eto da classe TRCell que o totaliador se refere
c6D Caracter 6dentificao do totaliador
c/unction Caracter
/uno que ser utiliada pelo totaliador "S+1, C(+7T, 1AL, 167,
AE&RAH&, M(+R$
o-rea. (b>eto
(b>eto da classe TR-rea. que define em qual quebra o totaliador ser
impresso
cTitle Caracter
T0tulo do totaliador. Se no informado ser utiliado o t0tulo da c%lula
que o totaliador se refere
cPicture Caracter
1scara de impresso do totaliador. Se no informado ser utiliado a
mscara da c%lula que o totaliador se refere
u/ormula "Iualquer$
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEP@ para
e5ecuo
l&ndSection @!2ico
6ndica se totaliador ser impresso na quebra de seo
Ealor padro' Eerdadeiro
l&ndReport @!2ico
6ndica se totaliador ser impresso no final do relat!rio
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
1%todo construtor da classe TR/unction.
( parametro que indica qual c%lula o totaliador se refere ,ser utiliado para posicionamento de
impresso do totaliador quando esti3er definido que a impresso ser por coluna e como conte=do para
a funo definida caso no se>a informada uma f!rmula para o totaliador
Pa$e2alue
Sintaxe
o(b>'Pa2eEalue " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Retorna o 3alor atual do totaliador para a p2ina
Report2alue
Sintaxe
o(b>'ReportEalue " $ ,,A uReportEalue
Retorno
Tipo Descrio
"Iualquer$ Ealor atual para o relat!rio
Descrio
Retorna o 3alor atual do totaliador para o relat!rio
Reset
Sintaxe
o(b>'Reset " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Reinicia 3alor do totaliador
ResetPa$e
Sintaxe
o(b>'ResetPa2e " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Reinicia 3alor do totaliador para a p2ina
ResetReport
Sintaxe
o(b>'ResetReport " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Reinicia 3alor do totaliador para o relat!rio
ResetSection
Sintaxe
o(b>'ResetSection " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Reinicia 3alor do totaliador para a seo
Section2alue
Sintaxe
o(b>'SectionEalue " $ ,,A uSectionEalue
Retorno
Tipo Descrio
"Iualquer$ Ealor atual para a seo
Descrio
Retorna o 3alor atual do totaliador para a seo
SetBrea/
Sintaxe
o(b>'Set-rea. " B o-rea. A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
o-rea. (b>eto (b>eto da classe TR-rea.
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a quebra "TR-rea.$ que o totaliador ser impresso
Set#ndPa$e
Sintaxe
o(b>'Set&ndPa2e " C l&ndPa2e D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
l&ndPa2e @!2ico
Eerdadeiro para imprimir no final da p2ina
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se o totaliador ser impresso no final da p2ina
Set#ndReport
Sintaxe
o(b>'Set&ndReport " C l&ndReport D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
l&ndReport @!2ico
Eerdadeiro para imprimir no final do relat!rio
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se o totaliador ser impresso no final do relat!rio
Set#ndSection
Sintaxe
o(b>'Set&ndSection " C l&ndSection D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
l&ndSection @!2ico
Eerdadeiro para imprimir na quebra de seo
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define se o totaliador ser impresso na quebra de seo
SetFormula
Sintaxe
o(b>'Set/ormula " B u/ormula A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
u/ormula "Iualquer$
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEP@ para
e5ecuo
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a f!rmula utiliada pelo totaliador ao in3%s do conte=do da c%lula que ele se refere
SetFunction
Sintaxe
o(b>'Set/unction " B c/unction A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
c/unction Caracter /uno que ser utiliada pelo totaliador
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a funo "S+1, C(+7T, 1AL, 167, AE&RAH&, M(+R$ que ser utiliada pelo totaliador
TRPosition
Descrio
C%lula de posicionamento de uma seo de um relat!rio que utilia a class TReport.
As c%lulas de posicionamento so e5ecutas em toda e5ecuo do m%todo Print@ine da seo que elas
pertencem, para posicionar as tabelas secundrias da seo que o usurio pode utiliar para incluir c%lulas
baseadas em seus campos.
Mtodos
Mtodo Descrio
New 1%todo construtor da classe TRPosition
SetTa*le Define a tabela que ser utitlia pela f!rmula para o posicionamento
Set$rder Define a ordem do 0ndice para o posicionamento
SetNic%Name Define a ordem do 0ndice pelo seu nic.name
Exec&te
&5ecuta a f!rmula de posicionamento definida no parametro do m%todo 7e4 ou
pelo m%todo Set/ormula
Ena*le Mabilita e5ecuo da c%lula de posicionamento
Disa*le Desabilita e5ecuo da c%lula de posicionamento
SetForm&la
Define a f!rmula de posicionamento da tabela informada por parametro pelo
m%todo 7e4 ou pelo m%todo SetTable
"isa3le
Sintaxe
o(b>'Disable " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Desabilita e5ecuo da c%lula de posicionamento
#na3le
Sintaxe
o(b>'&nable " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Mabilita e5ecuo da c%lula de posicionamento
#xecute
Sintaxe
o(b>'&5ecute " $ ,,A 76@
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
&5ecuta a f!rmula de posicionamento definida no parametro do m%todo 7e4 ou pelo m%todo Set/ormula
!e+
Sintaxe
TRPosition"$'7e4 " B oParent A , C cAlias D , C u(rder D , C u/ormula D , C lSee. D $ ,,A TRPosition
Parmetros
Argumento Tipo Descrio
oParent (b>eto (b>eto da classe TRSection que a c%lula pertence
cAlias Caracter Tabela que ser utiliada para posicionamento
u(rder "Iualquer$
Tipo Caracter' 7ic.name da ordem do 0ndice da tabela
Tipo 7um%rico' (rdem do 0ndice da tabela
u/ormula "Iualquer$
/!rmula de posicionamento
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEPl para
e5ecuo
lSee. @!2ico
Eerdadeiro para e5ecutar o DbSee. com o conte=do retornado pela
f!rmula
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
(b>eto (b>eto da classe TRPosition
Descrio
1%todo construtor da classe TRPosition
SetFormula
Sintaxe
o(b>'Set/ormula " B u/ormula A , C lSee. D $ ,,A 76@
Parmetros
Argumento Tipo Descrio
u/ormula "Iualquer$
/!rmula de posicionamento
Tipo Caracter' &5presso ADEP@ para macro e5ecuo
Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEPl para
e5ecuo
lSee. @!2ico
Eerdadeiro para e5ecutar o DbSee. com o conte=do retornado pela
f!rmula
Ealor padro' Eerdadeiro
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a f!rmula de posicionamento da tabela informada por parametro pelo m%todo 7e4 ou pelo m%todo
SetTable
Set!ic/!ame
Sintaxe
o(b>'Set7ic.7ame " B c7ic.name A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
c7ic.name Caracter 7ic.name do 0ndice
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a ordem do 0ndice pelo seu nic.name
Set)rder
Sintaxe
o(b>'Set(rder " B n(rder A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
n(rder 7um%rico (rdem do 0ndice
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a ordem do 0ndice para o posicionamento
SetTa3le
Sintaxe
o(b>'SetTable " B cAlias A $ ,,A 76@
Parmetros
Argumento Tipo Descrio
cAlias Caracter Tabela para posicionamento
Retorno
Tipo Descrio
"7+@($ Retorno nulo.
Descrio
Define a tabela que ser utitlia pela f!rmula para o posicionamento