TREPORT Guia Completo

  • Published on
    27-Sep-2015

  • View
    403

  • Download
    20

Embed Size (px)

DESCRIPTION

TREPORT Guia Completo

Transcript

  • TREPORT

    Produto : Microsiga Protheus, verso 10 Chamado : SCFHBTData da criao

    18/01/10 Data da reviso

    29/11/11.

    Pas(es) : Brasil Banco de Dados

    : Todos

    FNC : 00000026652/2009

    Este boletim tem o objetivo de informar a utilizao do objeto TReport para criao de relatrios, detalhando as propriedades e mtodos de cada classe utilizada no TReport.

    TREPORTClasse de impresso que substitui as funes SetPrint, SetDefault, RptStatus e Cabec.A classe TReport permite que o usurio personalize as informaes que sero apresentadas no relatrio, alterando fonte (tipo, tamanho, etc.), cor, tipo de linhas, cabealho, rodap, etc.

    Estrutura do componente TReport:O relatrio (TReport) contm uma ou mais sees (TRSection); Uma seo (TRSection) pode conter uma ou mais sees; A seo (TRSection) contm clulas pr-definidas e clulas selecionadas pelo usurio; A seo (TRSection) tambm contm as quebras (TRBreak) para impresso de totalizadores (TRFunction); Os totalizadores so includos pela seo que automaticamente inclui no relatrio

    (TReport).

    PropriedadesaBreak Array com todas as quebras totalizadoras do relatrio. Elemento: 1-Objeto

    TRBreak.aCollection Array com todos totalizadores do tipo TRCollection do relatrio.

    Elemento: 1-Objeto TRCollection.aCustomText Array contendo a customizao para impresso do cabealho padro.

    Elementos: 1=Texto a ser impresso, no qual, um elemento por linha. Existem algumas strings que pode auxiliar na criao do cabealho:

    __NOLINEBREAK__ - No quebra linha__NOTRANSFORM__ - Imprime sem nenhum tratamento__LOGOEMP__ - Imprime o logo da empresa__FATLINE__ - Imprime um linha grossa__THINLINE__ - Imprime uma linha fina

    FrameWork - TReport 1

  • aBmps Array com as imagens dos grficos enviadas por email. Elemento: 1- Caminho da imagem.

    aFontSize Array com as fontes do sistema. Elementos: 1-Fonte, 2-Tamanho, 3- Tamanho em pixel.

    aFunction Array com todos totalizadores do tipo TRFunction do relatrio. Elemento: 1-Objeto TRFunction.

    aHeaderPage Array com todas as sees que imprimem cabealho no topo da pgina.aSection Array com todas as sees do relatrio. Elemento: 1-Objeto TRSection.bAction Bloco de cdigo executado quando o usurio confirmar a impresso do relatrio.bCustomText Bloco de cdigo para atualizao da propriedade aCustomText.bOnNumberPage Bloco de cdigo para atualizao do nmero da pgina atual.bOnPageBreak Bloco de cdigo para tratamentos na inicializao de cada pgina.bTotal Compatibilidade No utilizado.bTotalCanPrint Bloco de cdigo utilizado para validar a impresso dos totalizadores.bTotalPos Bloco de cdigo utilizado para localizar a posio do totalizador a ser impresso.bTotalPrint Bloco de cdigo utilizado para imprimir os totalizadores.bTotalReset Bloco de cdigo utilizado para limpar os totalizadores.bTotalRSize Bloco de cdigo utilizado para definir o tamanho das Collections.bTotalText Bloco de cdigo utilizado na impresso do texto do totalizador.cClassName Nome da classe. Exemplo: TREPORT.cDate Data da impresso do relatrio.cDescription Descrio do relatrio.cDir Diretrio selecionado para gerao do relatrio.cEmail E-mail utilizado na gerao do relatrio via e-mail.cFontBody Fonte definida para impresso do relatrio.cFile Nome do arquivo que ser gerado.cID ID do component. Exemplo: TREPORT.cLogo Logo da empresa/filial.cMsgPrint Mensagem apresentada durante a gerao do relatrio.cPrinterName Nome da impressora selecionada para impresso.cReport Nome do relatrio. Exemplo: MATR010.cTime Hora da impresso do relatrio.cTitle Ttulo do relatrio.cRealTitle Ttulo padro do relatrio definido pelo criador do relatrio.cUserObs Observao do usurio.cXlsTHStyle Estilo do cabealho padro utilizado na gerao da planilha.cXlsSHStyle Estilo do cabealho utilizado na gerao da planilha.cXmlDefault Arquivo XML contendo Informaes do relatrio padro.cXlsFile Nome do arquivo que ser gerado em planilha.lBold Aponta que as Informaes sero impressas em negrito.lCanceled Aponta que o relatrio foi cancelado.lClrBack Define que a cor de fundo dever ser atualizada.

    2 FrameWork - TReport

  • lClrFore Define que a cor da fonte dever ser atualizada.lDisableOrientation Orientao (Retrato/Paisagem) no poder ser modificada.lDynamic Aponta que o relatrio dinmico, permitindo imprimir as sees conforme a

    ordem de impresso selecionada.lEdit Relatrio no poder ser configurado pelo usurio.lEnabled Impresso do relatrio foi desabilitada.lEmptyLineExcel Suprime as linhas em branco e os totais na gerao em planilha.lFooterVisible Habilita a impresso do rodap.lFunctionBefore Imprime os totalizadores do tipo TRFunction antes dos totalizadores do tipo

    TRCollecions.lHeaderVisible Habilita a impresso do cabealho.lItalic Aponta que as informaes sero impressas em itlico.lOnPageBreak Cabealho das sees impressas aps a quebra de pgina.lPageBreak Quebra pgina antes da impresso dos totalizadores.lParamPage Existe parmetros para impresso.lParamReadOnly Parmetros no podero ser alterados pelo usurio.lPixColSpace Espaamento das colunas sero calculadas em pixel.lPreview Visualizao do relatrio antes da impresso fsica.lPrinting Relatrio esta em processo de impresso.lPrtParamPage Aponta que sero impressos os parmetros do relatrio.lStartPage Aponta que uma nova pgina dever se inicializada.lTotalInLine Imprime as clulas no formato linha.lTPageBreak Quebra pgina aps a impresso do totalizador.lUnderline Aponta que as Informaes sero impressas sublinhadas.lUserAccess Valida permisso para gerao dos grficos do relatrio.lUserInfo Imprime Informaes do usurio na pgina de parmetros.lUserFilter Permite a utilizao de filtros na personalizao do relatrio.lXlsHeader Imprime informaes do cabealho padro na gerao em planilha.lNoPrint Aponta que nenhuma informao foi impressa.lXmlEndRow Aponta fim de linha na gerao em planilha.lXlsParam Aponta a existncia de parmetros na gerao em planilha.lEndReport Imprime total geral do relatrio.nBorderDiff Tamanho da borda utilizado para clculo da altura de uma linha.nClrBack Cor de fundo.nClrFore Cor da fonte.nCol Coluna posiciona na impresso.nColSpace Espaamento entre as colunas.nDevice Tipo de impresso selecionado. Opes: 1-Arquivo,2-Impressora,3-email,4-

    Planilha e 5-Html.nEnvironment Ambiente selecionado. Opes: 1-Server e 2-Cliente.nFontBody Tamanho da fonte definida para impresso do relatrio.nHeaderDiff Tamanho do cabealho utilizado para clculo do altura da pgina.nLeftMargin Tamanho da margem a esquerda.nLineHeight Altura da linha.

    FrameWork - TReport 3

  • nLogPxYDiff Utilizado no clculo para gerao da visualizao do relatrio.nLogPxXDiff Utilizado no clculo para gerao da visualizao do relatrio.nMeter Posio da rgua de progresso.nOrder Ordem de impresso selecionada.nPageWidth Largura da pgina.nPxColSpace Espaamento da coluna em pixel.nPxBase Tamanho da base em pixel.nPxDate Tamanho da sistema operacional em pixel.nPxLeftMargin Tamanho da margem a esquerda em pixel.nPxPage Tamanho da numerao da pgina em pixel.nPxTitle Tamanho do ttulo em pixel.nRemoteType Aponta de que forma o Server est gerando o relatrio. Opes: 1-Sem

    Remote, 2-Remote Delphi,3-Remote Windows e 4-Remote Linux.nRow Linha posicionada na impresso.nXlsCol Coluna posicionada na gerao em planilha.nXlsRow Linha posicionada na gerao em planilha.nXlsStyle Estilo utilizado na gerao em planilha.nExcel Nmero do arquivo na gerao em planilha.nColumnPos Posicionamento no arquivo gerado em planilha.oBrdBottom Objeto TRBorder com a borda Inferior .oBrdLeft Objeto TRBorder com a borda esquerda.oBrdRight Objeto TRBorder com a borda direita.oBrdTop Objeto TRBorder com a borda superior.oHBrdBottom Objeto TRBorder com a borda Inferior no cabealho.oHBrdLeft Objeto TRBorder com a borda esquerda no cabealho.oHBrdRight Objeto TRBorder com a borda direita no cabealho.oHBrdTop Objeto TRBorder com a borda superior no cabealho.oClrBack Objeto TBrush com a cor de Fundo.oFontBody Objeto TFont com a fonte do relatrio.oFontHeader Objeto TFont com a fonte do cabealho.oMeter Objeto TMeter com a rgua de progresso.oMsg Objeto TSAY com a mensagem apresentada durante a impresso do relatrio.oPage Objeto TRPage com a configurao da pgina de impresso.oParamPage Objeto TRParamPage com a configurao da pgina de parmetros.oPrint Objeto TMSPrinter.oReport Componente de impresso.oXlsCell Compatibilidade No utilizado.oXlsRow Compatibilidade No utilizado.oXlsStyles Compatibilidade No utilizado.oXlsWorksheet Compatibilidade No utilizado.uParam Parmetros do relatrio cadastrado no Dicionrio de Perguntas (SX1).

    Tambm pode ser utilizado bloco de cdigo para parmetros customizados.

    4 FrameWork - TReport

  • MTODOS

    AddBreak(oBreak)Adiciona a quebra de impresso na propriedade aBreak.oBreak Objeto TRBreak

    AddCollection(oCollection)Adiciona o totalizador na propriedade aCollection.oCollection Objeto TRCollection

    AddFunction(oFunction,oParent)Adiciona o totalizador na propriedade aFunction.oFunction Objeto TRFunctionoParent Objeto TRSecion que aponta a seo que pertence o totalizador

    AddHeaderPage(oSection)Adiciona a seo que imprime cabealho no topo da pgina.oSection Objeto TRSection

    AddSection(oSection)Adiciona a seo na propriedade aSection.oSection Objeto TRSection

    Border(uBorder,lHeader)Retorna a borda do relatrio.uBorder Tipo Caracter: "TOP","BOTTOM","LEFT","RIGHT",ALL

    Tipo Numrico: 1-Superior,2-Inferior,3-Esquerda,4-Direita,5-TodaslHeader Borda do cabealho

    Retorno Objeto do tipo TRBorder

    Box(nRow,nCol,nBottom,nRight,oPen)Desenha uma caixa, utilizando as especificaes do objeto TPen.nRow Linha no qual inicia o desenho da caixanCol Coluna no qual inicia o desenho da caixanBottom Linha no qual finaliza o desenho da caixanRight Coluna no qual finaliza o desenho da caixaoPen Objeto da classe TPen

    Cancel()Retorna se o usurio cancelou a impresso do relatrio.

    Cancel