Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

Cabec

Cabec( <cTitulo>, <cCabec1>, <cCabec2>, <cPrograma>, <cTamanho>, [nFormato], [uPar7], [lPerg], [cLogo] ) --> nLin

Emite cabeçalho em um fluxo de relatório legado preparado.

CabecAdvPL
01 · VISÃO GERAL

Visão geral

Cabec pertence ao fluxo de impressão legado e retorna um número de linha. A ficha histórica exige título, duas linhas de cabeçalho, programa e tamanho P/M/G; inclui formato, posição reservada, opção de perguntas e logotipo BMP. O exemplo é um fragmento para saída de teste já configurada: não prepara impressora, spool, paginação ou encerramento do relatório. Nil preserva a sétima posição reservada; .F. torna explícita a escolha de não imprimir perguntas, sem depender do MV_IMPSX1. Não interpretar a linha devolvida como quantidade de registros impressos. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

Cabec( <cTitulo>, <cCabec1>, <cCabec2>, <cPrograma>, <cTamanho>, [nFormato], [uPar7], [lPerg], [cLogo] ) --> nLin

Parâmetros

cTitulo
CaractereObrigatório

Título do relatório.

cCabec1
CaractereObrigatório

Primeira linha do cabeçalho.

cCabec2
CaractereObrigatório

Segunda linha do cabeçalho.

cPrograma
CaractereObrigatório

Identificação do programa.

cTamanho
CaractereObrigatório

P, M ou G conforme formato.

nFormato
NuméricoOpcional

Formato de impressão; 15 no exemplo.

uPar7
QualquerOpcional

Reservado; manter Nil.

lPerg
LógicoOpcional

Impressão de perguntas; se omitido consulta MV_IMPSX1.

cLogo
CaractereOpcional

Nome do logotipo BMP no fluxo suportado.

Retorno

Número da linha devolvida pelo fluxo de impressão.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function EdCabec()
    Local nLinha
    // Somente dentro de fluxo legado com saida de teste preparada.
    nLinha := Cabec("Resumo editorial", "Codigo  Descricao", "", "EDCAB", "M", 15, Nil, .F.)
    ConOut(cValToChar(nLinha))
Return Nil
Resultado esperado

Propõe emitir o cabeçalho e registrar a linha; sem fluxo de impressão preparado o exemplo não é autossuficiente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Homologar em saída de teste, sem dados reais e sem envio automático à impressora. Tratar paginação e encerramento no programa do relatório.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Cabec. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha