Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

Cabec

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

Emite encabezado en flujo de informe legado preparado.

CabecAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

Cabec pertenece a impresión legada y devuelve número de línea. Ficha histórica exige título, dos líneas de encabezado, programa y tamaño P/M/G; opciones incluyen formato, posición reservada, preguntas y logo BMP. Fragmento requiere salida de prueba configurada: no prepara impresora, spool, paginación ni cierre. Nil conserva séptima posición reservada; .F. desactiva preguntas explícitamente sin depender de MV_IMPSX1. Línea devuelta no es cantidad de registros impresos. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

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

Parámetros

cTitulo
CarácterObligatorio

Título del informe.

cCabec1
CarácterObligatorio

Primera línea del encabezado.

cCabec2
CarácterObligatorio

Segunda línea del encabezado.

cPrograma
CarácterObligatorio

Identificación del programa.

cTamanho
CarácterObligatorio

P, M o G según formato.

nFormato
NuméricoOpcional

Formato de impresión; 15 en ejemplo.

uPar7
CualquieraOpcional

Reservado; mantener Nil.

lPerg
LógicoOpcional

Imprime preguntas; si se omite consulta MV_IMPSX1.

cLogo
CarácterOpcional

Nombre de logo BMP en flujo soportado.

Retorno

Número de línea devuelto por flujo de impresión.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function EdCabec()
    Local nLinea
    // Solo dentro de flujo legado con salida de prueba preparada.
    nLinea := Cabec("Resumen editorial", "Codigo  Descripcion", "", "EDCAB", "M", 15, Nil, .F.)
    ConOut(cValToChar(nLinea))
Return Nil
Resultado esperado

Propone emitir encabezado y registrar línea; sin flujo de impresión preparado no es autosuficiente. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Probar salida de prueba, datos ficticios y sin envío automático a impresora. Tratar paginación y cierre en programa del informe.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. Cabec. TDN. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha