Protheus.chBase e comandosOpcional
Reúne traduções de funções Protheus, comandos gerais e inclui diversos arquivos especializados. Símbolos observados: Functions U_, P_, T_, W_ e H_; STACKVAR; Dialog.ch; Font.ch; PTMenu.ch; Print.ch; Colors.ch.
CATáLOGOEm revisão
Catálogo histórico de includes do Protheus
#Include "<arquivo>.ch"Consulte a finalidade observada em 50 arquivos .ch de um pacote histórico e saiba quais exigem validação no release atual.
Visão geral
O pacote include_001.zip reúne 50 includes e um arquivo de controle de versão. A maior parte dos arquivos está datada de 28 de fevereiro de 2007 e apresenta cabeçalhos de copyright Microsiga de 1997–2003; CTBR040.ch e CTBR150.ch são de 2005. O conjunto registra como comandos, traduções e constantes eram organizados naquele período. Ele é usado neste guia para orientar pesquisa e manutenção de fontes legados, nunca como substituto do pacote oficial do release atual.
Sintaxe
#Include "<arquivo>.ch"Parâmetros
TopConn.chSQL e DBAccessOpcional
Declara o comando TCQUERY usado para abrir resultados SQL por meio da RDD TOPCONN. Símbolos observados: TCQUERY.
TBIconn.chAmbiente e RPCOpcional
Agrupa comandos históricos de preparação de ambiente, conexão RPC, transações remotas e tabelas remotas. Símbolos observados: PREPARE ENVIRONMENT; RESET ENVIRONMENT; CREATE/CLOSE RPCCONN; CALLPROC.
StdWin.chSintaxe e interface legadaOpcional
Possui grande quantidade de comandos e traduções xBase, estruturas de controle e construções visuais históricas. Símbolos observados: DO WHILE; ENDIF; ENDCASE; NEXT; DO; CALL; STORE.
SigaWin.chInterface Protheus legadaOpcional
Expande comandos visuais, impressão e convenções de funções utilizadas pela interface histórica do Protheus. Símbolos observados: Debug; BTNAUTFMT; PSAY; USER FUNCTION; PROW(); PCOL().
RWMake.chCompatibilidade legadaOpcional
Concentra comandos antigos de interface e impressão e inclui StdWin.ch. Deve ser estudada para manutenção, não adotada automaticamente em fontes novos. Símbolos observados: DIALOG; ACTIVATE DIALOG; BITMAP; PSAY; USER FUNCTION.
FileIO.chArquivosOpcional
Define modos de abertura, compartilhamento e posicionamento usados por funções de arquivos de baixo nível. Símbolos observados: F_ERROR; FS_SET; FS_RELATIVE; FS_END; FO_READ; FO_WRITE; FO_READWRITE.
Error.chTratamento de errosOpcional
Define severidades e categorias numéricas usadas por objetos e rotinas de erro. Símbolos observados: ES_WARNING; ES_ERROR; ES_CATASTROPHIC; EG_ARG; EG_BOUND; EG_ZERODIV; EG_SYNTAX.
DBInfo.chRDD e banco de dadosOpcional
Reúne identificadores para informações de registros, recursos da RDD, bloqueios e características da tabela. Símbolos observados: DBRI_DELETED; DBRI_LOCKED; DBRI_RECNO; DBI_ISDBF; DBI_GETRECSIZE; DBI_GETLOCKARRAY.
VKey.chTecladoOpcional
Define códigos históricos de teclas virtuais usados em eventos de teclado e interface. Símbolos observados: VK_RETURN; VK_TAB; VK_SHIFT; VK_CONTROL; VK_ESCAPE e outras VK_*.
Colors.chCoresOpcional
Define constantes de cores e a tradução RGB() usada por componentes visuais. Símbolos observados: RGB(); CLR_BLACK; CLR_BLUE; CLR_RED; CLR_HGRAY e outras CLR_*.
WinAPI.chWindows legadoOpcional
Reúne constantes da API do Windows para janelas, mensagens, botões e estilos. É dependente de plataforma e requer cautela. Símbolos observados: IDOK; IDCANCEL; BN_CLICKED; CS_*; WS_*.
Retorno
Inventário editorial: 50 arquivos .ch, um arquivo .scc e 12 includes inicialmente priorizadas para páginas próprias.
Como investigar uma dependência
// 1. Localize o comando ou constante no fonte.
// 2. Pesquise o símbolo no pacote de includes do release.
// 3. Confirme a documentação atual.
// 4. Inclua apenas o arquivo necessário.Resultado esperado
A dependência fica explícita e vinculada ao release correto, sem copiar includes históricas para o ambiente.
- Use o catálogo para localizar a provável origem de um símbolo em código legado.
- Confirme o símbolo no pacote oficial do release antes de compilar ou alterar o fonte.
- TOTVS.ch deve permanecer a referência geral quando essa for a orientação oficial do recurso atual.
- Páginas individuais estão em revisão até que documentação atual confirme suporte e comportamento.
- O material didático gerado pela Google em 8 ago. 2026 foi usado como pauta, mas suas afirmações foram confrontadas com o pacote disponível e reformuladas quando confundiam editor, pré-processador, funções convencionais, persistência MVC ou keywords TLPP.
- Datas do arquivo ZIP não equivalem necessariamente à data original de criação de cada include.
- Arquivos CTBR040.ch e CTBR150.ch contêm textos específicos de rotinas e não são documentação geral.
- O arquivo vssver.scc é metadado de controle de versão, não uma include AdvPL.
- O pacote não contém TOTVS.ch e não deve ser usado para substituir o conjunto atual do ambiente.
- Conteúdo gerado por IA deve ser tratado como fonte auxiliar: exemplos e equivalências internas precisam de verificação técnica antes da publicação.