Includes são arquivos *.ch utilizados para importar referências de outros códigos fontes para o fonte atual, incorporando assim recursos e funcionalidades padrões de forma rápida e prática. Por exemplo, quando se insere no STR0001 no código, caso eu tenha um include com essa definição, o Protheus utilizará o valor atribuído a ela para exibir na customização).
Sintaxe:
#include “<arquivo cabeçalho>”A diretiva #include inclui um arquivo cabeçalho no arquivo de programa (.PRW). Onde o <arquivo cabeçalho> define o nome de outro arquivo de programa contendo um código-fonte a ser incluído no arquivo de programa corrente. O nome deve ser obrigatoriamente delimitado por aspas simples ou duplas.
A Include a TOTVS.ch é muito utilizada atualmente, porque já carrega dentro de sua arquitetura as funcionalidades de Includes essenciais para o funcionamento de um programa, sendo que em poucos casos precisamos adicionar outras Includes.
Também existem includes especificas que são padronizadas em rdmakes e relatórios, que quando usamos tais fontes, precisamos tê-las, como por exemplo
Mas quais includes devo usar em meus códigos? Veja alguns exemplos de includes e suas finalidades:
Protheus.ch – Include padrão do Protheus, devendo se utilizar como padrão a TOTVS.ch.
TOTVS.ch – Include padrão para as customizações.
RWMake.ch – Include possui recursos para montagens da tela, a mesma antecede a Protheus.ch, mas atualmente deve-se utilizar a TOTVS.ch.
FWMVCDef.ch – Include para criação de fontes em MVC.
TopConn.ch – Include mantem recursos e funções para uso de conexões via Top Connect (como a tão utilizada TCQuery()).
TbiConn.ch – Include comumente usada para fazer integrações entre sistemas, juntamente com TbiCode.ch.
TbiCode.ch – Include comumente usada para fazer integrações entre sistemas, juntamente com TbiConn.ch.
FWPrintSetup.ch – Include com recursos e constantes para criação de relatórios gráficos, utilizando a classe FWMSPrinter().
FileIO.ch – Include utilizada para controlar input e output de arquivos, atualmente não sendo necessário o uso, se utilizar a Include TOTVS.ch e as classes FWFileWriter() e FWFileReader().
Ap5Mail.ch – Include utilizada antigamente para disparo de e-Mail, não sendo mais necessária no dias de hoje, bastando utilizar a Include TOTVS.ch e a classe TMailMessage().
ApWebSrv.ch – Include utilizada para a chamada de WebServices.
ApWizard.ch – Include utilizada na criação de telas no formato Wizard, não sendo mais necessário o uso, se utilizado a Include TOTVS.ch e a classe FWWizardControl().
Colors.ch – Esta Include possui cores pré definidas em constantes (como CLR_HRED, CLR_HBLUE, etc), porém acredito ser mais fácil o uso da função RGB().
Font.ch – Include de fontes, mas se fizer uso na Include TOTVS.ch e a classe TFont(), terá um resultado muito melhor.
ParmType.ch – Include utilizada para tipagem de parâmetros vindo em funções, que atualmente pode ser substituído pelo uso da Include TOTVS.ch juntamente com prefixo Default ao se receber um parâmetro.
XMLxFun.ch – Include com recursos para integração com arquivos XML, exemplo a função XMLDelNode().
RPTDef.ch – Include disponibiliza alguns recursos para relatórios do Protheus.
Fonte: TDN – TOTVS
Adicionar comentário