Manual do TReport

Descrio Classe de impresso que substitui as funes SetPrint, SetDefault, RptStatus e Cabec. A classe TReport permite que o usurio personali e 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 totali adores "TR/unction$* (s totali adores so inclu0dos pela seo que automaticamente inclui no relat!rio "TReport$.

Mtodos Mtodo New SetTitle SetParam Preview SetAction Descrio 1%todo construtor da classe TReport. Define o t0tulo do componente. Define os parametros que sero utili ados pelo usurio para confi2urar o relatorio. Apresenta pre3ie4 do relat!rio. Define o bloco de c!di2o que ser e5ecutado quando o usurio confirmar a impresso 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. Apresenta a tela de impresso para o usurio confi2urar o relat!rio. PrintDialog ( 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. Retorna se o usurio cancelou a impresso do relat!rio. Define o total da re2ua da tela de processamento do relat!rio. 6ncrementa a r%2ua da tela de processamento do relat!rio Define a descrio do componente. Retorna o nome da classe do componente. &5emplo' oReport '8 TReport"$'7e4"91ATR:):9$ 1s2Stop"oReport'Class7ame"$$ ;;Apresenta na tela 9TR&P(RT9 Retorna o nome do relat!rio "e5emplo' 1ATR:):$ Retorna o t0tulo do componente Descrio do componente Retorna o te5to que ser impresso antes da impresso dos totali adores

Print

Cancel SetMeter IncMeter SetDescription

ClassName

ReportName Title Description TotalText

GetParam GetAction FooterAtEnd TotalIn ine Page!eig"t Page#idt" Row Col Page Get$rientation Printing

Retorna a per2unta;bloco de c!di2o utili ada como parametro do relat!rio. Retorna bloco de c!di2o que ser e5ecutado pelos m%todos Print e PrintDialo2 quando usurio confirmar impresso. Retorna se ser impressore rodap% no final da impresso Retorna se a impresso dos totali adores ser em lin#a Retorna a altura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio Retorna a lar2ura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio Retorna a lin#a posicionada na impresso Retorna a coluna posicionada na impresso Retorna o n=mero da p2ina atual na impresso Retorna a orientao de p2ina "Retrato ou Paisa2em$ selecionada pelo usurio. 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 finali ao$. 6nciali a impresso. 7o % necessrio e5ecutar o m%todo 6nit se for utili ar o m%todo Print ou PrintDialo2, > que estes fa em o controle de iniciali ao e finali ao da impresso. Caso no este>a utili ando os m%todo citados acima, sempre e5ecute o m%todo 6nit no in0dio do relat!rio para 3erificar as confi2uraes informadas pelo usurio e iniciali ar corretamente a primeira p2ina do relat!rio. /inali a impresso iniciali ada pelo m%todo 6nit. 7o % necessrio e5ecutar o m%todo /inis# se for utili ar o m%todo Print ou PrintDialo2, > que estes fa em o controle de iniciali ao e finali ao da impresso.

Init

Finis" Caso no este>a utili ando os m%todo citados acima, sempre e5ecute o m%todo /inis# no final do relat!rio para impresso dos totali adores 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. 6mprime o te5to nas coordenadas informadas pelos parametros /inali a um p2ina de impresso 6ncrementa a lin#a de impresso baseado no parametro ou no 3alor definido pelo usurio para a altura das lin#as do relat!rio. Salta uma lin#a baseado na altura da lin#a informada pelo usurio Define o te5to que ser impresso antes da impresso dos totali adores Define se os totali adores sero impressos em lin#a ou coluna Define orientao de p2ina do relat!rio como retrato Define a orientao de p2ina do relat!rio como paisa2em Define se ser apresentado o pre3ie4 o relat!rio no final da impresso Retorna ob>eto da classe TR/unction "totali adores$ baseado no parametro informado. Retorna ob>eto da classe TRSection "seo$ baseado no parametro informado. 6mprime te5to nas coordenadas informadas pelos parametros, utili ando as especificaes do ob>eto T/ont, cor da fonte e cor de fundo 6mprime uma ima2em nas coordenadas informadas pelos parametros Desen#a uma lin#a baseado nas coordenadas informadas pelos parametros,

PrintText EndPage IncRow S%ip ine SetTotalText SetTotalIn ine SetPortrait Set andscape SetPreview GetF&nction Section Sa' Sa'(itmap ine

(ox FillRect T"in ine Fat ine

utili ando as especificaes do ob>eto TPen. Desen#a uma cai5a baseado nas coordenadas informadas pelos parametros, utili ando as especificaes do ob>eto TPen. Preenc#e um retan2ulo na impresso utili ando as especificaes do ob>eto T-rus#. Desen#a uma lin#a simples iniciando na lin#a atual de impresso com a lar2ura da p2ina 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 utili ar 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 personali aveis 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 utili ar 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 personali aveis 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 utili ar 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 utili ada 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 utili ada 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 utili ar 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 Local o+ection8 Local o+ection$ 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" !rintReport(oReport) '( oReport'+ection(8) '( oReport'+ection(8)'+ection(8) '( ""

*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 "7+@($ Descrio Reinicia 3alor do totali ador para o relat!rio Descrio Retorno nulo.

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 nRo4 nCol n-ottom nRi2#t oPen Retorno Tipo "7+@($ Descrio Desen#a uma cai5a baseado nas coordenadas informadas pelos parametros, utili ando as especificaes do ob>eto TPen. Descrio Retorno nulo. Tipo 7um%rico 7um%rico 7um%rico 7um%rico (b>eto Descrio @in#a inicial Coluna inicial @in#a final Coluna final (b>eto da classe TPen

ancel
Sintaxe o(b>'Cancel " $ ,,A lCanceled Retorno Tipo @!2ico Descrio Retorna se o usurio cancelou a impresso do relat!rio. Descrio Eerdadeiro se usurio cancelou impresso

lass!ame
Sintaxe o(b>'Class7ame " $ ,,A cClass7ame Retorno Tipo Caracter Descrio Retorna o nome da classe do componente. &5emplo' oReport '8 TReport"$'7e4"91ATR:):9$ 1s2Stop"oReport'Class7ame"$$ ;;Apresenta na tela 9TR&P(RT9 Descrio 7ome da classe

ol
Sintaxe o(b>'Col " $ ,,A nCol Retorno Tipo 7um%rico Descrio Retorna a coluna posicionada na impresso Descrio Coluna posicionada na impresso

"escription
Sintaxe o(b>'Description " $ ,,A cDescription Retorno Tipo Caracter Descrio Descrio do componente Descrio Descrio do componente

#ndPa$e
Sintaxe o(b>'&ndPa2e " C l/ooter D $ ,,A 76@ Parmetros Argumento l/ooter Tipo @!2ico Descrio 6mprime rodap%. Ealor padro' /also

Retorno Tipo "7+@($ Descrio /inali a uma p2ina de impresso Descrio Retorno nulo.

Fat%ine
Sintaxe o(b>'/at@ine " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Descrio Retorno nulo.

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 aRect o-rus# Retorno Tipo "7+@($ Descrio Preenc#e um retan2ulo na impresso utili ando as especificaes do ob>eto T-rus#. Descrio Retorno nulo. Tipo Arra? (b>eto Descrio Eetor com coordenadas no formato' Flin#a inicial, coluna inicial, lin#a final, coluna finalG (b>eto da classe T-rus#

Finis&
Sintaxe o(b>'/inis# " $ ,,A 76@ Retorno Tipo "7+@($ Descrio /inali a impresso iniciali ada pelo m%todo 6nit. 7o % necessrio e5ecutar o m%todo /inis# se for utili ar o m%todo Print ou PrintDialo2, > que estes fa em o controle de iniciali ao e finali ao da impresso. Caso no este>a utili ando os m%todo citados acima, sempre e5ecute o m%todo /inis# no final do relat!rio para impresso dos totali adores 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. Descrio Retorno nulo.

Footer't#nd
Sintaxe

o(b>'/ooterAt&nd " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna se ser impressore rodap% no final da impresso Descrio Retorno nulo.

(et'ction
Sintaxe o(b>'HetAction " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna bloco de c!di2o que ser e5ecutado pelos m%todos Print e PrintDialo2 quando usurio confirmar impresso. Descrio Retorno nulo.

(etFunction
Sintaxe o(b>'Het/unction " B u/unction A $ ,,A o/unction Parmetros Argumento u/unction Tipo "Iualquer$ Descrio Tipo Caracter' 6D do ob>eto Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos componentes TR/unction

Retorno Tipo (b>eto Descrio (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 "totali adores$ baseado no parametro informado.

(et)rientation

Sintaxe o(b>'Het(rientation " $ ,,A n(rientation Retorno Tipo 7um%rico Descrio (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 "Iualquer$ Descrio Retorna a per2unta;bloco de c!di2o utili ada como parametro do relat!rio. Descrio Per2unta "SL)$ ou bloco de c!di2o utili ado como parametro

*ncMeter
Sintaxe o(b>'6nc1eter " C n6nc D $ ,,A 76@ Parmetros Argumento n6nc Tipo 7um%rico Descrio Iuantidade a incrementar na r%2ua. Ealor padro' )

Retorno Tipo "7+@($ Descrio 6ncrementa a r%2ua da tela de processamento do relat!rio Descrio Retorno nulo.

*ncRo+
Sintaxe o(b>'6ncRo4 " C n6nc D $ ,,A 76@ Parmetros Argumento n6nc Tipo 7um%rico Descrio Iuantidade a incrementar. Ealor padro definida pelo usurio para a altura da lin#a

Retorno Tipo "7+@($ 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. Descrio Retorno nulo.

*nit
Sintaxe o(b>'6nit " $ ,,A 76@ Retorno Tipo "7+@($ Descrio 6nciali a impresso. 7o % necessrio e5ecutar o m%todo 6nit se for utili ar o m%todo Print ou PrintDialo2, > que estes fa em o controle de iniciali ao e finali ao da impresso. Caso no este>a utili ando os m%todo citados acima, sempre e5ecute o m%todo 6nit no in0dio do relat!rio para 3erificar as confi2uraes informadas pelo usurio e iniciali ar corretamente a primeira p2ina do relat!rio. Descrio Retorno nulo.

%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 nTop nCol n-ottom nRi2#t oPen Retorno Tipo "7+@($ Descrio

Tipo 7um%rico 7um%rico 7um%rico 7um%rico (b>eto

Descrio @in#a inicial Coluna inicial @in#a final Coluna final (b>eto da classe TPen

Descrio Retorno nulo.

Desen#a uma lin#a baseado nas coordenadas informadas pelos parametros, utili ando as especificaes do ob>eto TPen.

Pa$e
Sintaxe o(b>'Pa2e " $ ,,A nPa2e Retorno Tipo 7um%rico Descrio Retorna o n=mero da p2ina atual na impresso Descrio 7=mero da p2ina

Pa$e,ei$&t
Sintaxe o(b>'Pa2eMei2#t " $ ,,A nPa2eMei2#t Retorno Tipo 7um%rico Descrio Retorna a altura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio Descrio Altura da p2ina

Pa$e-idt&
Sintaxe

o(b>'Pa2eNidt# " $ ,,A nPa2eNidt# Retorno Tipo 7um%rico Descrio Retorna a lar2ura da p2ina baseado no taman#o da fol#a "A<, Carta, etc$ informado pelo usurio Descrio @ar2ura da p2ina

Pre.ie+
Sintaxe o(b>'Pre3ie4 " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Apresenta pre3ie4 do relat!rio. Descrio Retorno nulo.

Print
Sintaxe o(b>'Print " C lDl2 D $ ,,A 76@ Parmetros Argumento lDl2 Retorno Tipo "7+@($ 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. Descrio Retorno nulo. Tipo @!2ico Descrio Eerdadeiro para apresentar a tela de processamento do relat!rio

Print"ialo$

Sintaxe o(b>'PrintDialo2 " C bAction D $ ,,A lPrinted Parmetros Argumento bAction Tipo Code,-loc. Descrio -loco de c!di2o que ser e5ecutado quando usurio confirmar a impresso do relat!rio

Retorno Tipo @!2ico 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. Descrio Eerdadeiro se usurio confirmou impresso do relat!rio

PrintText
Sintaxe o(b>'PrintTe5t " B cTe5t A , C nRo4 D , C nCol D $ ,,A 76@ Parmetros Argumento cTe5t nRo4 nCol Tipo Caracter 7um%rico 7um%rico Descrio Te5to que ser impresso @in#a que o te5to ser impresso. Ealor padro' lin#a posicionada da impresso Coluna que o te5to ser impresso. Ealor padro' coluna posicionada da impresso

Retorno Tipo "7+@($ Descrio 6mprime o te5to nas coordenadas informadas pelos parametros Descrio Retorno nulo.

Printin$
Sintaxe o(b>'Printin2 " $ ,,A lPrintin2

Retorno Tipo @!2ico 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 finali ao$. Descrio Eerdadeiro se relat!rio esta no processo de impresso

Report!ame
Sintaxe o(b>'Report7ame " $ ,,A cReport Retorno Tipo Caracter Descrio Retorna o nome do relat!rio "e5emplo' 1ATR:):$ Descrio 7ome do relat!rio

Ro+
Sintaxe o(b>'Ro4 " $ ,,A nRo4 Retorno Tipo 7um%rico Descrio Retorna a lin#a posicionada na impresso Descrio @in#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 nCol cTe5t o/ont nNidt# nClrTe5t n-.1ode Retorno Tipo "7+@($ Descrio

7um%rico 7um%rico Caracter (b>eto 7um%rico 7um%rico 7um%rico

@in#a para impresso do te5to Coluna para impresso do te5to Te5to que ser impresso (b>eto da classe T/ont Taman#o em pi5el do te5to para impresso Cor da fonte Cor de fundo

Descrio Retorno nulo.

6mprime te5to nas coordenadas informadas pelos parametros, utili ando 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 n@in#a nCol c-itmap nNidt# nMei2#t Retorno Tipo "7+@($ Descrio 6mprime uma ima2em nas coordenadas informadas pelos parametros Descrio Retorno nulo. Tipo 7um%rico 7um%rico 7um%rico 7um%rico 7um%rico Descrio @in#a para impresso da ima2em Coluna para impresso da ima2em 7ome da ima2em "arqui3o ou resource compilado no reposit!rio$ @ar2ura da ima2em Altura da ima2em

Section
Sintaxe o(b>'Section " B uSection A $ ,,A oSection Parmetros

Argumento uSection

Tipo "Iualquer$

Descrio Tipo Caracter' T0tulo do ob>eto Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos componentes TRSection

Retorno Tipo (b>eto Descrio (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 bAction Tipo Code,-loc. Descrio -loco de c!di2o que ser e5ecutado quando usurio confirmar a impresso do relat!rio

Retorno Tipo "7+@($ Descrio Define o bloco de c!di2o que ser e5ecutado quando o usurio confirmar a impresso Descrio Retorno nulo.

Set"escription
Sintaxe o(b>'SetDescription " B cDesc A $ ,,A 76@ Parmetros Argumento cDesc Retorno Tipo "7+@($ Descrio Retorno nulo. Tipo Caracter Descrio Descrio do componente

Descrio Define a descrio do componente.

Set%andscape
Sintaxe o(b>'Set@andscape " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Define a orientao de p2ina do relat!rio como paisa2em Descrio Retorno nulo.

SetMeter
Sintaxe o(b>'Set1eter " B nTotal A $ ,,A 76@ Parmetros Argumento nTotal Retorno Tipo "7+@($ Descrio Define o total da re2ua da tela de processamento do relat!rio. Descrio Retorno nulo. Tipo 7um%rico Descrio Total da re2ua de processamento

SetParam
Sintaxe o(b>'SetParam " B uParam A $ ,,A 76@ Parmetros Argumento uParam Tipo "Iualquer$ Descrio Tipo Caracter' Parametros do relat!rio cadastrado no Dicionrio de Per2untas "SL)$ Tipo -loco de c!di2o' bloco que ser utili ado como parametro

Retorno Tipo "7+@($ Descrio Define os parametros que sero utili ados pelo usurio para confi2urar o relatorio. Descrio Retorno nulo.

SetPortrait
Sintaxe o(b>'SetPortrait " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Define orientao de p2ina do relat!rio como retrato Descrio Retorno nulo.

SetPre.ie+
Sintaxe o(b>'SetPre3ie4 " C lPre3ie4 D $ ,,A 76@ Parmetros Argumento lPre3ie4 Tipo @!2ico Descrio Eerdadeiro para apresentar pre3ie4 no final da impresso Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se ser apresentado o pre3ie4 o relat!rio no final da impresso Descrio Retorno nulo.

SetTitle
Sintaxe o(b>'SetTitle " B cTitle A $ ,,A 76@

Parmetros Argumento cTitle Retorno Tipo "7+@($ Descrio Define o t0tulo do componente. Descrio Retorno nulo. Tipo Caracter Descrio T0tulo do componente

SetTotal*n%ine
Sintaxe o(b>'SetTotal6n@ine " C lTotal6n@ine D $ ,,A 76@ Parmetros Argumento lTotal6n@ine Tipo @!2ico Descrio Eerdadeiro se totali adores sero impressos em lin#a Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se os totali adores sero impressos em lin#a ou coluna Descrio Retorno nulo.

SetTotalText
Sintaxe o(b>'SetTotalTe5t " B cTe5to A $ ,,A 76@ Parmetros Argumento cTe5to Retorno Tipo "7+@($ Descrio Retorno nulo. Tipo Caracter Descrio Te5to para impresso antes dos totali adores

Descrio Define o te5to que ser impresso antes da impresso dos totali adores

S/ip%ine
Sintaxe o(b>'S.ip@ine " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Salta uma lin#a baseado na altura da lin#a informada pelo usurio Descrio Retorno nulo.

T&in%ine
Sintaxe o(b>'T#in@ine " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Desen#a uma lin#a simples iniciando na lin#a atual de impresso com a lar2ura da p2ina Descrio Retorno nulo.

Title
Sintaxe o(b>'Title " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna o t0tulo do componente Descrio Retorno nulo.

Total*n%ine

Sintaxe o(b>'Total6n@ine " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna se a impresso dos totali adores ser em lin#a Descrio Retorno nulo.

TotalText
Sintaxe o(b>'TotalTe5t " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna o te5to que ser impresso antes da impresso dos totali adores Descrio Retorno nulo.

#xemplos

#xemplo de utili0ao da 1uno MPReport

Para utili ar 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 utili adas 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 utili ar 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 personali aveis 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 utili ar 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 personali aveis 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 utili ar 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 utili ada 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 utili ada 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 utili ar 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 Local o+ection8 Local o+ection$ 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 !rintReport(oReport) '( oReport'+ection(8) '( oReport'+ection(8)'+ection(8) '( ""

C.F:9/)3) #*,)IF

o+ection8'!rint() Return

TRSection
Descrio Seo de um relat!rio que utili a a classe TReport. A classe TRSection pode ser entendida como um la?out do relat!rio, por conter c%lulas, quebras e totali adores que daro um formato para sua impresso. Com a classe TRSection % poss03el definir uma quer?, filtro ou 0ndice com filtro "6ndRe2ua$ que ser utili ada por ela para processamento do relat!rio, atra3%s do m%todo Print e utili ando 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 1%todo construtor da classe TRSection 7o parametro onde % informado as tabelas utili adas pela seo, a primeira ser a principal, sendo utili ada para o processamento pelo m%todo Print. As outras tabelas sero utili adas 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 utili ada pela seo sero criados os ob>etos da classe TR(rder automaticamente, utili ando como 0ndice da tabela principal a ordem do elemento no 3etor. Retorna o ob>eto pai da classe TRSection Retorna o ob>eto da classe TReport que a classe TRSection pertence Retorna se salta a p2ina na quebra de seo Retorna se cabeal#o das c%lulas ser impresso ap!s uma quebra "TR-rea.$ Retorna se cabeal#o das c%lulas ser impresso na quebra de seo Retorna se o componente esta #abilitada para impresso Retorna o alias utili ado pela quer? da seo, que foi definida pelo &mbedded SI@ com os m%todos -e2inIuer? e &ndIuer? Mabilita a impresso do componente Desabilita a impresso da seo, por%m todas as lin#as sero processadas, somente no aparecero no relat!rio. Retorna se o usurio pode alterar o la?out da seo 6niciali a seo. 7o % necessrio e5ecutar o m%todo 6nit se for utili ar o m%todo Print, > que este fa o controle de iniciali ao e finali ao das sees. Caso no este>a utili ando o m%todo Print, sempre e5ecute o m%todo 6nit para iniciali ar a seo, para controle de quebra de p2ina entre sees, impresso do cabeal#o das c%lulas e para outros tratamentos internos do componente. /inali a seo iniciali ada pelo m%todo 6nit.

New

Parent Report Page(rea% !eader(rea% !eaderSection )isi*le Alias S"ow !ide lRead$nl'

Init

Finis"

7o % necessrio e5ecutar o m%todo /inis# se for utili ar o m%todo Print, > que este fa o controle de iniciali ao e finali ao das sees. Caso no este>a utili ando o m%todo Print, sempre e5ecute o m%todo /inis# ao finali ar uma seo, para controle da impresso dos totali adores 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. 6mprime a lin#a baseado nas c%lulas selecionadas pelo usurio 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. Retorna ob>eto da classe TRCell "c%lula$ baseado no parametro informado. Retorna ob>eto da classe TR(rder "ordem$ basead no parametro informado Carre2a campos do Dicionrio de Campos "SLO$ como c%lulas da seo, respeitando n03el, uso e conte5to do campo Carre2a 0ndices do Dicionrio de Jndices "S6L$ como ordem da seo Define se salta a p2ina na quebra de seo Define se imprime cabeal#o das c%lulas ap!s uma quebra "TR-rea.$ Define de imprime cabeal#o das c%lulas na quebra de seo 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. 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. 6ndica que ser utili ado o &mbedded SI@ para criao de uma no3a quer? que ser utili ada pela seo 6ndica a quer? criada utili ando 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 utili ada tanto pela classe TRSection como para o fonte que esta criando os componentes, sem a necessidade de utili ar TCHenIuer?, C#an2eIuer? e TCSet/ield. Define se a seo fil#a utili ara a quer? da seo pai no processamento do m%todo Print Define a re2ra de sa0da do loop de processamento do m%todo Print das sees fil#as 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

Print ine

Print

Cell $rder oadCells oad$rder SetPage(rea% Set!eader(rea% Set!eaderSection

SetRead$nl'

Get+&er' (egin+&er'

End+&er'

SetParent+&er' SetParentFilter

SetFilter

Set$rder SetIdx$rder Get$rder

Define a ordem "TR(rder$ que ser utili ada pela seo Define uma ordem de 0ndice para a tabela principal Retorna a ordem selecionada pelo usurio Retorna o 0ndice utili ado pela tabela principal da seo para processamento pelo m%todo Print. Se o retorno for ero, ento a seo esta utili ando uma ordem selecionada pelo usurio "TR(rder$ Define a f!rmula de relacionamento de uma seo fil#a com sua seo pai, caso no utili e a quer? da seo pai "SetParentIuer?$

GetIdx$rder

SetRelation

( 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 Caracter Descrio Retorna o alias utili ado pela quer? da seo, que foi definida pelo &mbedded SI@ com os m%todos -e2inIuer? e &ndIuer? Descrio Alias utili ado pela quer?

Be$inQuery
Sintaxe o(b>'-e2inIuer? " $ ,,A 76@ Retorno Tipo "7+@($ Descrio 6ndica que ser utili ado o &mbedded SI@ para criao de uma no3a quer? que ser utili ada pela seo Descrio Retorno nulo.

ell
Sintaxe o(b>'Cell " B uCell A $ ,,A oCell

Parmetros Argumento uCell Tipo "Iualquer$ Descrio 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 (b>eto Descrio (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 uParam Tipo "Iualquer$ Descrio Per2unta "e5emplo' m3Ppar:)$ ou lista de per2untas "e5emplo' Fm3Ppar:), m3Ppar:KG$ do tipo Ran2e que sero incluidas na quer?

Retorno Tipo "7+@($ Descrio 6ndica a quer? criada utili ando 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 utili ada tanto pela classe TRSection como para o fonte que esta criando os componentes, sem a necessidade de utili ar TCHenIuer?, C#an2eIuer? e TCSet/ield. Descrio Retorno nulo.

Finis&
Sintaxe o(b>'/inis# " $ ,,A 76@ Retorno

Tipo "7+@($ Descrio

Descrio Retorno nulo.

/inali a seo iniciali ada pelo m%todo 6nit. 7o % necessrio e5ecutar o m%todo /inis# se for utili ar o m%todo Print, > que este fa o controle de iniciali ao e finali ao das sees. Caso no este>a utili ando o m%todo Print, sempre e5ecute o m%todo /inis# ao finali ar uma seo, para controle da impresso dos totali adores 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 7um%rico Descrio Retorna o 0ndice utili ado pela tabela principal da seo para processamento pelo m%todo Print. Se o retorno for ero, ento a seo esta utili ando uma ordem selecionada pelo usurio "TR(rder$ Descrio Jndice utili ado

(et)rder
Sintaxe o(b>'Het(rder " $ ,,A n(rder Retorno Tipo 7um%rico Descrio Retorna a ordem selecionada pelo usurio Descrio (rdem selecionada pelo usurio

(etQuery
Sintaxe o(b>'HetIuer? " $ ,,A cIuer?

Retorno Tipo Caracter 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. Descrio Iuer? utili ada pela seo

,eaderBrea/
Sintaxe o(b>'Meader-rea. " $ ,,A lMeader-rea. Retorno Tipo @!2ico Descrio Retorna se cabeal#o das c%lulas ser impresso ap!s uma quebra "TR-rea.$ Descrio Eerdadeiro se imprime cabeal#o

,eaderSection
Sintaxe o(b>'MeaderSection " $ ,,A lMeaderSection Retorno Tipo @!2ico Descrio Retorna se cabeal#o das c%lulas ser impresso na quebra de seo Descrio Eerdadeiro se imprime cabeal#o

,ide
Sintaxe o(b>'Mide " $ ,,A 76@ Retorno Tipo "7+@($ Descrio 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 "7+@($ Descrio 6niciali a seo. 7o % necessrio e5ecutar o m%todo 6nit se for utili ar o m%todo Print, > que este fa o controle de iniciali ao e finali ao das sees. Caso no este>a utili ando o m%todo Print, sempre e5ecute o m%todo 6nit para iniciali ar a seo, para controle de quebra de p2ina entre sees, impresso do cabeal#o das c%lulas e para outros tratamentos internos do componente. Descrio Retorno nulo.

%oad ells
Sintaxe o(b>'@oadCells " C cTable D , C aCells D $ ,,A 76@ Parmetros Argumento cTable aCells Tipo Caracter Arra? Descrio Tabela que ser utili ada para carre2ar os campos. Se no for informada ser utili ado todas as tabelas informadas no m%todo 7e4 da classe TRSection. Eetor com nome dos campos que sero carre2ados como c%lulas da seo

Retorno Tipo "7+@($ Descrio Carre2a campos do Dicionrio de Campos "SLO$ como c%lulas da seo, respeitando n03el, uso e conte5to do campo Descrio Retorno nulo.

%oad)rder
Sintaxe o(b>'@oad(rder " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Carre2a 0ndices do Dicionrio de Jndices "S6L$ como ordem da seo Descrio Retorno nulo.

!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 oParent cTitle uTable a(rder l@oadCells l@oad(rder Tipo (b>eto Caracter "Iualquer$ Arra? @!2ico @!2ico Descrio (b>eto da classe TReport ou TRSection que ser o pai da classe TRSection T0tulo da seo Tabela ou lista de tabelas que sero utili adas pela seo Eetor com a descrio das ordens Eerdadeiro para carre2ar os campos do Dicionrio de Campos "SLO$ das tabelas da seo como c%lulas Ealor padro' /also Eerdadeiro para carre2ar os 0ndices do Dicionrio de Jndices "S6L$ Ealor padro' /also

Retorno Tipo (b>eto Descrio 1%todo construtor da classe TRSection 7o parametro onde % informado as tabelas utili adas pela seo, a primeira ser a principal, sendo utili ada para o processamento pelo m%todo Print. As outras tabelas sero utili adas 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. Descrio (b>eto da classe TRSection

Dos elementos do parametro onde so informadas as ordens utili ada pela seo sero criados os ob>etos da classe TR(rder automaticamente, utili ando 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 u(rder Tipo "Iualquer$ Descrio Tipo Caracter' 7ic.name da ordem Tipo 7um%rico' Jndice do ob>eto se2undo a ordem de criao dos componentes TR(rder

Retorno Tipo (b>eto Descrio Retorna ob>eto da classe TR(rder "ordem$ basead no parametro informado Descrio (b>eto da classe TR(rder

Pa$eBrea/
Sintaxe o(b>'Pa2e-rea. " $ ,,A lPa2e-rea. Retorno Tipo @!2ico Descrio Retorna se salta a p2ina na quebra de seo Descrio Eerdadeiro se quebra a p2ina

Parent
Sintaxe o(b>'Parent " $ ,,A oParent Retorno Tipo (b>eto Descrio (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 "7+@($ 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. Descrio Retorno nulo.

Print%ine
Sintaxe o(b>'Print@ine " $ ,,A 76@ Retorno Tipo "7+@($ Descrio 6mprime a lin#a baseado nas c%lulas selecionadas pelo usurio Descrio Retorno nulo.

Report
Sintaxe o(b>'Report " $ ,,A 76@ Retorno Tipo "7+@($ Descrio 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 c/ilter c6nde5Qe? Retorno Tipo "7+@($ 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 Descrio Retorno nulo. Tipo Caracter Caracter Descrio &5presso de filtro no formato ADEP@ C#a3e de 0ndice

Set,eaderBrea/
Sintaxe o(b>'SetMeader-rea. " C lMeader-rea. D $ ,,A 76@ Parmetros Argumento lMeader-rea. Tipo @!2ico Descrio Eerdadeiro para imprimir o cabeal#o Ealor padro' 3erdadeiro

Retorno Tipo "7+@($ Descrio Define se imprime cabeal#o das c%lulas ap!s uma quebra "TR-rea.$ Descrio Retorno nulo.

Set,eaderSection

Sintaxe o(b>'SetMeaderSection " C lMeaderSection D $ ,,A 76@ Parmetros Argumento lMeaderSection Tipo @!2ico Descrio Eerdadeiro para imprimir o cabeal#o Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define de imprime cabeal#o das c%lulas na quebra de seo Descrio Retorno nulo.

Set*dx)rder
Sintaxe o(b>'Set6d5(rder " B n6d5(rder A $ ,,A 76@ Parmetros Argumento n6d5(rder Retorno Tipo "7+@($ Descrio Define uma ordem de 0ndice para a tabela principal Descrio Retorno nulo. Tipo 7um%rico Descrio (rdem do 0ndice

Set)rder
Sintaxe o(b>'Set(rder " B n(rdem A $ ,,A 76@ Parmetros Argumento n(rdem Tipo 7um%rico Descrio (rdem que ser utili ada

Retorno Tipo "7+@($ Descrio Define a ordem "TR(rder$ que ser utili ada pela seo Descrio Retorno nulo.

SetPa$eBrea/
Sintaxe o(b>'SetPa2e-rea. " C lPa2e-rea. D $ ,,A 76@ Parmetros Argumento lPa2e-rea. Tipo @!2ico Descrio Eerdadeiro para saltar a p2ina Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se salta a p2ina na quebra de seo Descrio Retorno nulo.

SetParentFilter
Sintaxe o(b>'SetParent/ilter " B b/ilter A , C bParam D $ ,,A 76@ Parmetros Argumento b/ilter bParam Tipo Code,-loc. Code,-loc. Descrio -loco de c!di2o com a re2ra para sa0da do loop -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 "7+@($ Descrio Descrio Retorno nulo.

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 lParentIuer? Tipo @!2ico Descrio Eerdadeiro para utili ar quer? da seo pai Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se a seo fil#a utili ara a quer? da seo pai no processamento do m%todo Print Descrio Retorno nulo.

SetRead)nly
Sintaxe o(b>'SetRead(nl? " C SetRead(nl? D $ ,,A 76@ Parmetros Argumento SetRead(nl? Tipo @!2ico Descrio Eerdadeiro para desabilitar alterao do la?out Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ 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. Descrio Retorno nulo.

SetRelation
Sintaxe

o(b>'SetRelation " B b/ormula A , C cAlias D , C u(rder D , C lSee. D $ ,,A 76@ Parmetros Argumento b/ormula cAlias u(rder lSee. Tipo Code,-loc. Caracter "Iualquer$ @!2ico Descrio -loco de c!di2o com a e5presso para relacionamento entre as sees Tabela utili ada pela f!rmula (rdem utili ada tabela Tipo Caracter' 7ic.name da ordem de 0ndice Tipo 7um%rico' (rdem do 0ndice 6ndica se ser e5ecutado DbSee. com o conte=do da f!rmula Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define a f!rmula de relacionamento de uma seo fil#a com sua seo pai, caso no utili e 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. Descrio Retorno nulo.

S&o+
Sintaxe o(b>'S#o4 " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Mabilita a impresso do componente Descrio Retorno nulo.

2isi3le
Sintaxe o(b>'Eisible " $ ,,A lEisible Retorno Tipo @!2ico Descrio 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 @!2ico Descrio Retorna se o usurio pode alterar o la?out da seo Descrio Eerdadeiro se usurio no pode alterar o la?out

TRBrea/
Descrio Iuebra de uma seo de um relat!rio que utili a a classe TReport. A classe TR-rea. % utili ada para impresso dos totali adores da seo antes do final da mesma ou do relat!rio, dependendo da re2ra de quebra informada. Mtodos Mtodo New Set(rea% Exec&te Descrio 1%todo construtor da classe TR-rea. Define a re2ra para a quebra &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 @!2ico 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. Descrio 6ndique que #ou3e uma quebra

!e+
Sintaxe TR-rea."$'7e4 " B oParent A , C u-rea. D , C cTitle D , C lTotal6n@ine D $ ,,A TR-rea. Parmetros Argumento oParent u-rea. Tipo (b>eto "Iualquer$ Descrio (b>eto da classe TRSection que a quebra pertence Re2ra para quebra

cTitle lTotal6n@ine

Caracter @!2ico

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 T0tulo da quebra Eerdadeiro se totali adores sero impressos em lin#a Ealor padro' /also

Retorno Tipo (b>eto Descrio 1%todo construtor da classe TR-rea. Descrio (b>eto da classe TR-rea.

SetBrea/
Sintaxe o(b>'Set-rea. " B u-rea. A $ ,,A 76@ Parmetros Argumento Tipo Descrio 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

u-rea.

"Iualquer$

Retorno Tipo "7+@($ Descrio Define a re2ra para a quebra Descrio Retorno nulo.

TR ell
Descrio C%lula de impresso de uma seo "TRSection$ de um relat!rio que utili a a classe TReport Mtodos Mtodo 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 atuali ado com as informaes do Dicionrio de Campos "SLO$. New ( nome da c%lula ser utili ado >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 utili ado 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$ Mabilita impresso da c%lula Desabilita impresso da c%lula, ou se>a, a c%lula no ser impressa e seu poscionamento no ser calculado Desabilita impresso da c%lula, por%m continua calculando seu poscionamento Retorna a coluna que a c%lula ser impressa pelo m%todo Print@ine da seo que a c%lula pertence A3alia as informaes da c%lula para a impresso do conte=do pelo m%todo Print@ine da seo que a c%lula pertente Retorna a lar2ura da c%lula Retorna o te5to que ser impresso pelo m%todo Print@ine da seo que a c%lula pertence Carre2a informaes "t0tulo, picture, taman#o, etc$ do campo informado pelo parametro baseado no Dicionrio de Campos "SLO$ Define a mscara de impresso da c%lula Define o taman#o da c%lula, em pi5el ou n=mero de caracteres 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 utili ara mais o nome mais o alias para retornar o conte=do de impresso. Define um 3alor constante para a c%lula. Definindo um 3alor constante para a c%lula, esta no utili ara 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 utili ando nome mais alias. Define o alin#amento da c%lula na impresso.

Ena*le Disa*le !ide ColPos Exec&te Get#idt" GetText GetFieldIn,o SetPict&re SetSi-e Set(loc%

Set)al&e

SetAlign

( 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 Define que a c%lula ir imprimir a descrio do item de um campo que ten#a o formato Combo-o5, utili ado no Dicionrio de Campos "SLO$ ( formato do parametro % o mesmo utili ado no Dicionrio de Campos "SLO$, como no e5emplo abai5o' oCell'SetC-o5"9)8Sim*K87o9$. 7a impresso ser utili ado 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. Retorna o 3alor constante da c%lula definido pelo m%todo SetEalue

SetC(ox

Get)al&e

olPos
Sintaxe o(b>'ColPos " $ ,,A nCol Retorno Tipo 7um%rico Descrio Retorna a coluna que a c%lula ser impressa pelo m%todo Print@ine da seo que a c%lula pertence Descrio Coluna de impresso da c%lula

"isa3le
Sintaxe o(b>'Disable " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Desabilita impresso da c%lula, ou se>a, a c%lula no ser impressa e seu poscionamento no ser calculado Descrio Retorno nulo.

#na3le

Sintaxe o(b>'&nable " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Mabilita impresso da c%lula Descrio Retorno nulo.

#xecute
Sintaxe o(b>'&5ecute " $ ,,A 76@ Retorno Tipo "7+@($ 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 Descrio Retorno nulo.

(etField*n1o
Sintaxe o(b>'Het/ield6nfo " B c/ield A $ ,,A 76@ Parmetros Argumento c/ield Retorno Tipo "7+@($ Descrio Carre2a informaes "t0tulo, picture, taman#o, etc$ do campo informado pelo parametro baseado no Dicionrio de Campos "SLO$ Descrio Retorno nulo. Tipo Caracter Descrio 7ome do campo

(etText

Sintaxe o(b>'HetTe5t " $ ,,A cTe5t Retorno Tipo Caracter Descrio Retorna o te5to que ser impresso pelo m%todo Print@ine da seo que a c%lula pertence Descrio Te5to para impresso

(et2alue
Sintaxe o(b>'HetEalue " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna o 3alor constante da c%lula definido pelo m%todo SetEalue Descrio Retorno nulo.

(et-idt&
Sintaxe o(b>'HetNidt# " $ ,,A nNidt# Retorno Tipo 7um%rico Descrio Retorna a lar2ura da c%lula Descrio @ar2ura da c%lula

,ide
Sintaxe o(b>'Mide " $ ,,A 76@ Retorno

Tipo "7+@($ Descrio

Descrio Retorno nulo.

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 nSi e D , C lPi5el D , C b-loc. D $ ,,A TRCell Parmetros Argumento oParent c7ame cAlias cTitle cPicture nSi e lPi5el b-loc. Retorno Tipo (b>eto 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 atuali ado com as informaes do Dicionrio de Campos "SLO$. ( nome da c%lula ser utili ado >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 utili ado 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$ Descrio (b>eto da classe TRCell Tipo (b>eto Caracter Caracter Caracter Caracter 7um%rico @!2ico Code,-loc. Descrio (b>eto da classe TRSection que a c%lula pertence 7ome da c%lula Alias utili ado pela c%lula T0tulo da c%lula 1scara de impresso da c%lula Taman#o da c%lula, em pi5el ou n=mero de caracteres 6ndica se taman#o esta sendo informado em pi5el -loco de c!di2o que retornar o conte=do da c%lula

Set'li$n
Sintaxe o(b>'SetAli2n " B nAli2n A $ ,,A 76@

Parmetros Argumento nAli2n Tipo Caracter Descrio Tipo de alin#amento R@&/TR , esquerda RR6HMR , direita RC&7T&RR , centro

Retorno Tipo "7+@($ 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 Descrio Retorno nulo.

SetBloc/
Sintaxe o(b>'Set-loc. " B b-loc. A $ ,,A 76@ Parmetros Argumento b-loc. Retorno Tipo "7+@($ 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 utili ara mais o nome mais o alias para retornar o conte=do de impresso. Descrio Retorno nulo. Tipo Code,-loc. Descrio -loco de c!di2o com e5presso que retornar o conte=do de impresso

Set Box
Sintaxe o(b>'SetC-o5 " B cC-o5 A $ ,,A 76@

Parmetros Argumento cC-o5 Retorno Tipo "7+@($ Descrio Define que a c%lula ir imprimir a descrio do item de um campo que ten#a o formato Combo-o5, utili ado no Dicionrio de Campos "SLO$ ( formato do parametro % o mesmo utili ado no Dicionrio de Campos "SLO$, como no e5emplo abai5o' oCell'SetC-o5"9)8Sim*K87o9$. 7a impresso ser utili ado 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. Descrio Retorno nulo. Tipo Caracter Descrio Te5to com os itens e descrio do Combo-o5

SetPicture
Sintaxe o(b>'SetPicture " B cPicture A $ ,,A 76@ Parmetros Argumento cPicture Retorno Tipo "7+@($ Descrio Define a mscara de impresso da c%lula Descrio Retorno nulo. Tipo Caracter Descrio 1scara de impresso da c%lula, no formato ADEP@

SetSi0e
Sintaxe o(b>'SetSi e " B nSi e A , C lPi5el D $ ,,A 76@ Parmetros Argumento nSi e Tipo 7um%rico Descrio Taman#o da c%lula

lPi5el

@!2ico

6ndica se taman#o esta sendo informado em pi5el Ealor padro' /also

Retorno Tipo "7+@($ Descrio Define o taman#o da c%lula, em pi5el ou n=mero de caracteres Descrio Retorno nulo.

Set2alue
Sintaxe o(b>'SetEalue " C uParam D $ ,,A 76@ Parmetros Argumento uParam Retorno Tipo "7+@($ Descrio Define um 3alor constante para a c%lula. Definindo um 3alor constante para a c%lula, esta no utili ara 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 utili ando nome mais alias. Descrio Retorno nulo. Tipo "Iualquer$ Descrio Define 3alor constante para a c%lula

TRFunction
Descrio Totali ador de uma quebra, seo ou relat!rio que utili a a classe TReport. +m totali ador pode e5ecutar uma das se2uintes funes abai5o, utili ando 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 totali ador sempre % informado uma seo "TRSection$ a qual ele pertence, e automaticamente o totali ador ser incluido no relat!rio "TReport$ que a seo pertence. Mtodos Mtodo Descrio 1%todo construtor da classe TR/unction. ( parametro que indica qual c%lula o totali ador se refere ,ser utili ado para posicionamento de impresso do totali ador 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 totali ador Retorna a f!rmula do totali ador Retorna o 3alor atual do totali ador para a seo Retorna o 3alor atual do totali ador para a p2ina Retorna o 3alor atual do totali ador para o relat!rio Retorna a funo "S+1, C(+7T, 1AL, 167, AE&RAH&$ utili ada pelo totali ador. Retorna se o totali ador ser impresso na quebra de seo Retorna se totali ador ser impresso no final da p2ina Retorna se totali ador ser impresso no final do relat!rio &5ecuta a funo do totali ador, utili ando 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 totali ador pertence. Reinicia 3alor do totali ador Reinicia 3alor do totali ador para a seo Reinicia 3alor do totali ador para a p2ina Reinicia 3alor do totali ador para o relat!rio Define a f!rmula utili ada pelo totali ador ao in3%s do conte=do da c%lula que ele se refere Define a quebra "TR-rea.$ que o totali ador ser impresso Define a funo "S+1, C(+7T, 1AL, 167, AE&RAH&, M(+R$ que ser utili ada pelo totali ador Define se o totali ador ser impresso na quebra de seo

New

Form&la Section)al&e Page)al&e Report)al&e GetF&nction EndSection EndPage EndReport

Exec&te

Reset ResetSection ResetPage ResetReport SetForm&la Set(rea% SetF&nction SetEndSection

SetEndPage SetEndReport

Define se o totali ador ser impresso no final da p2ina Define se o totali ador ser impresso no final do relat!rio

#ndPa$e
Sintaxe o(b>'&ndPa2e " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna se totali ador ser impresso no final da p2ina Descrio Retorno nulo.

#ndReport
Sintaxe o(b>'&ndReport " $ ,,A l&ndReport Retorno Tipo @!2ico Descrio Eerdadeiro para imprimir no final do relat!rio Ealor padro' Eerdadeiro

Descrio Retorna se totali ador ser impresso no final do relat!rio

#ndSection
Sintaxe o(b>'&ndSection " $ ,,A l&ndSection Retorno Tipo @!2ico Descrio Retorna se o totali ador ser impresso na quebra de seo Descrio Eerdadeiro se imprime na quebra de seo

#xecute

Sintaxe o(b>'&5ecute " $ ,,A 76@ Retorno Tipo "7+@($ Descrio &5ecuta a funo do totali ador, utili ando 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 totali ador pertence. Descrio Retorno nulo.

Formula
Sintaxe o(b>'/ormula " $ ,,A u/ormula Retorno Tipo "Iualquer$ Descrio , (b>eto da classe TRCell ou * , te5to para macro e5ecuo ou * , bloco de c!di2o

Descrio Retorna a f!rmula do totali ador

(etFunction
Sintaxe o(b>'Het/unction " $ ,,A c/unction Retorno Tipo Caracter Descrio Retorna a funo "S+1, C(+7T, 1AL, 167, AE&RAH&$ utili ada pelo totali ador. Descrio /uno utili ada pelo totali ador

!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 oParent c6D c/unction o-rea. cTitle cPicture u/ormula l&ndSection l&ndReport Tipo (b>eto Caracter Caracter (b>eto Caracter Caracter "Iualquer$ @!2ico @!2ico Descrio (b>eto da classe TRCell que o totali ador se refere 6dentificao do totali ador /uno que ser utili ada pelo totali ador "S+1, C(+7T, 1AL, 167, AE&RAH&, M(+R$ (b>eto da classe TR-rea. que define em qual quebra o totali ador ser impresso T0tulo do totali ador. Se no informado ser utili ado o t0tulo da c%lula que o totali ador se refere 1scara de impresso do totali ador. Se no informado ser utili ado a mscara da c%lula que o totali ador se refere Tipo Caracter' &5presso ADEP@ para macro e5ecuo Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEP@ para e5ecuo 6ndica se totali ador ser impresso na quebra de seo Ealor padro' Eerdadeiro 6ndica se totali ador ser impresso no final do relat!rio Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio 1%todo construtor da classe TR/unction. ( parametro que indica qual c%lula o totali ador se refere ,ser utili ado para posicionamento de impresso do totali ador 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 totali ador Descrio Retorno nulo.

Pa$e2alue
Sintaxe o(b>'Pa2eEalue " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Retorna o 3alor atual do totali ador para a p2ina Descrio Retorno nulo.

Report2alue
Sintaxe o(b>'ReportEalue " $ ,,A uReportEalue Retorno Tipo "Iualquer$ Descrio Retorna o 3alor atual do totali ador para o relat!rio Descrio Ealor atual para o relat!rio

Reset
Sintaxe o(b>'Reset " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Reinicia 3alor do totali ador Descrio Retorno nulo.

ResetPa$e
Sintaxe o(b>'ResetPa2e " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Reinicia 3alor do totali ador para a p2ina Descrio Retorno nulo.

ResetReport
Sintaxe o(b>'ResetReport " $ ,,A 76@

Retorno Tipo "7+@($ Descrio Reinicia 3alor do totali ador para o relat!rio Descrio Retorno nulo.

ResetSection
Sintaxe o(b>'ResetSection " $ ,,A 76@ Retorno Tipo "7+@($ Descrio Reinicia 3alor do totali ador para a seo Descrio Retorno nulo.

Section2alue
Sintaxe o(b>'SectionEalue " $ ,,A uSectionEalue Retorno Tipo "Iualquer$ Descrio Retorna o 3alor atual do totali ador para a seo Descrio Ealor atual para a seo

SetBrea/
Sintaxe o(b>'Set-rea. " B o-rea. A $ ,,A 76@ Parmetros Argumento o-rea. Tipo (b>eto Descrio (b>eto da classe TR-rea.

Retorno Tipo "7+@($ Descrio Define a quebra "TR-rea.$ que o totali ador ser impresso Descrio Retorno nulo.

Set#ndPa$e
Sintaxe o(b>'Set&ndPa2e " C l&ndPa2e D $ ,,A 76@ Parmetros Argumento l&ndPa2e Tipo @!2ico Descrio Eerdadeiro para imprimir no final da p2ina Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se o totali ador ser impresso no final da p2ina Descrio Retorno nulo.

Set#ndReport
Sintaxe o(b>'Set&ndReport " C l&ndReport D $ ,,A 76@ Parmetros Argumento l&ndReport Tipo @!2ico Descrio Eerdadeiro para imprimir no final do relat!rio Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se o totali ador ser impresso no final do relat!rio Descrio Retorno nulo.

Set#ndSection
Sintaxe o(b>'Set&ndSection " C l&ndSection D $ ,,A 76@ Parmetros Argumento l&ndSection Tipo @!2ico Descrio Eerdadeiro para imprimir na quebra de seo Ealor padro' Eerdadeiro

Retorno Tipo "7+@($ Descrio Define se o totali ador ser impresso na quebra de seo Descrio Retorno nulo.

SetFormula
Sintaxe o(b>'Set/ormula " B u/ormula A $ ,,A 76@ Parmetros Argumento u/ormula Tipo "Iualquer$ Descrio Tipo Caracter' &5presso ADEP@ para macro e5ecuo Tipo -loco de C!di2o' -loco de C!di2o com a e5presso ADEP@ para e5ecuo

Retorno Tipo "7+@($ Descrio Define a f!rmula utili ada pelo totali ador ao in3%s do conte=do da c%lula que ele se refere Descrio Retorno nulo.

SetFunction
Sintaxe o(b>'Set/unction " B c/unction A $ ,,A 76@ Parmetros

Argumento c/unction Retorno Tipo "7+@($ Descrio

Tipo Caracter

Descrio /uno que ser utili ada pelo totali ador

Descrio Retorno nulo.

Define a funo "S+1, C(+7T, 1AL, 167, AE&RAH&, M(+R$ que ser utili ada pelo totali ador

TRPosition
Descrio C%lula de posicionamento de uma seo de um relat!rio que utili a 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 utili ar para incluir c%lulas baseadas em seus campos. Mtodos Mtodo New SetTa*le Set$rder SetNic%Name Exec&te Ena*le Disa*le SetForm&la Descrio 1%todo construtor da classe TRPosition Define a tabela que ser utitli a pela f!rmula para o posicionamento Define a ordem do 0ndice para o posicionamento Define a ordem do 0ndice pelo seu nic.name &5ecuta a f!rmula de posicionamento definida no parametro do m%todo 7e4 ou pelo m%todo Set/ormula Mabilita e5ecuo da c%lula de posicionamento Desabilita e5ecuo da c%lula de posicionamento 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 "7+@($ Descrio Desabilita e5ecuo da c%lula de posicionamento Descrio Retorno nulo.

#na3le
Sintaxe o(b>'&nable " $ ,,A 76@ Retorno Tipo Descrio

"7+@($ Descrio

Retorno nulo.

Mabilita e5ecuo da c%lula de posicionamento

#xecute
Sintaxe o(b>'&5ecute " $ ,,A 76@ Retorno Tipo "7+@($ Descrio &5ecuta a f!rmula de posicionamento definida no parametro do m%todo 7e4 ou pelo m%todo Set/ormula Descrio Retorno nulo.

!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 oParent cAlias u(rder Tipo (b>eto Caracter "Iualquer$ Descrio (b>eto da classe TRSection que a c%lula pertence Tabela que ser utili ada para posicionamento Tipo Caracter' 7ic.name da ordem do 0ndice da tabela Tipo 7um%rico' (rdem do 0ndice da tabela /!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 Eerdadeiro para e5ecutar o DbSee. com o conte=do retornado pela f!rmula Ealor padro' Eerdadeiro

u/ormula

"Iualquer$

lSee.

@!2ico

Retorno Tipo (b>eto Descrio 1%todo construtor da classe TRPosition Descrio (b>eto da classe TRPosition

SetFormula
Sintaxe o(b>'Set/ormula " B u/ormula A , C lSee. D $ ,,A 76@ Parmetros Argumento u/ormula Tipo "Iualquer$ Descrio /!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 Eerdadeiro para e5ecutar o DbSee. com o conte=do retornado pela f!rmula Ealor padro' Eerdadeiro

lSee.

@!2ico

Retorno Tipo "7+@($ Descrio Define a f!rmula de posicionamento da tabela informada por parametro pelo m%todo 7e4 ou pelo m%todo SetTable Descrio Retorno nulo.

Set!ic/!ame
Sintaxe o(b>'Set7ic.7ame " B c7ic.name A $ ,,A 76@ Parmetros Argumento c7ic.name Retorno Tipo "7+@($ Descrio Define a ordem do 0ndice pelo seu nic.name Descrio Retorno nulo. Tipo Caracter Descrio 7ic.name do 0ndice

Set)rder
Sintaxe

o(b>'Set(rder " B n(rder A $ ,,A 76@ Parmetros Argumento n(rder Retorno Tipo "7+@($ Descrio Define a ordem do 0ndice para o posicionamento Descrio Retorno nulo. Tipo 7um%rico Descrio (rdem do 0ndice

SetTa3le
Sintaxe o(b>'SetTable " B cAlias A $ ,,A 76@ Parmetros Argumento cAlias Retorno Tipo "7+@($ Descrio Define a tabela que ser utitli a pela f!rmula para o posicionamento Descrio Retorno nulo. Tipo Caracter Descrio Tabela para posicionamento