Saltar para o conteúdo principal
Versão: Próximo

Print form

Print form ( {aTable ;} form {; formData} {; areaStart{; areaEnd}} ) : Integer

ParâmetroTipoDescrição
aTableTabela→Table owning the form, or Default table, if omitted
formText, Object→Name (string) of the form, or a POSIX path (string) to a .json file describing the form, or an object describing the form to print
formDataObject→Dados para associar ao formulário
areaStartInteger→Print marker, or Beginning area (if areaEnd is specified)
areaEndInteger→Área final (se for especificado pela areaStart)
ResultadoInteger←Height of printed section

Descrição​

Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable.Print form simply prints form with the current values of fields and variables of aTable. It is usually used to print very complex reports that require complete control over the printing process. Print form does not do any record processing, break processing or page breaks. These operations are your responsibility. Print form prints fields and variables in a fixed size frame only.

No parâmetro form, você pode passar:

  • o nome de um formulário, ou
  • the path (in POSIX syntax) to a valid .json file containing a description of the form to use (see Form file path), or
  • um objeto contendo uma descrição do formulário.

Since Print form does not issue a page break after printing the form, it is easy to combine different forms on the same page. Thus, Print form is perfect for complex printing tasks that involve different tables and different forms. Para forçar uma quebra de página entre os formulários, use o comando PAGE BREAK. In order to carry printing over to the next page for a form whose height is greater than the available space, call the CANCEL command before the PAGE BREAK command.

Three different syntaxes may be used:

  • Impressão da área de detalhe

Sintaxe:

 height:=Print form(myTable;myForm)

In this case, Print form only prints the Detail area (the area between the Header line and the Detail line) of the form.

  • Impressão da área de formulário

Sintaxe:

 height:=Print form(myTable;myForm;marker)

In this case, the command will print the section designated by the marker. Pass one of the constants of the Form Area theme in the marker parameter:

ParâmetrosTipoValor
Form break0Integer300
Form break1Integer301
Form break2Integer302
Form break3Integer303
Form break4Integer304
Form break5Integer305
Form break6Integer306
Form break7Integer307
Form break8Integer308
Form break9Integer309
Form detailInteger0
Form footerInteger100
Form headerInteger200
Form header1Integer201
Form header10Integer210
Form header2Integer202
Form header3Integer203
Form header4Integer204
Form header5Integer205
Form header6Integer206
Form header7Integer207
Form header8Integer208
Form header9Integer209
  • Impressão da seção

Sintaxe:

 height:=Print form(myTable;myForm;areaStart;areaEnd)

In this case, the command will print the section included between the areaStart and areaEnd parameters. The values entered must be expressed in pixels.

formData

Opcionalmente, é possível passar parâmetros para o form usando o objeto formData ou o objeto de classe de formulário instanciado automaticamente pelo 4D se você tiver [associado uma classe de usuário ao formulário] (../FormEditor/properties_FormProperties.md#form-class). Todas as propriedades do objeto de dados do formulário estarão disponíveis no contexto do formulário por meio do comando Form. Optionally, you can pass parameters to the form using either the formData object or the form class object automatically instantiated by 4D if you have associated a user class to the form.

Para obter informações detalhadas sobre o objeto de dados do formulário, consulte o comando DIALOG.

Valor retornado

The value returned by Print form indicates the height of the printable area. Esse valor será automaticamente levado em conta pelo comando Get printed height.

The printer dialog boxes do not appear when you use Print form. The report does not use the print settings that were assigned to the form in the Design environment. There are two ways to specify the print settings before issuing a series of calls to Print form:

Print form* cria cada página impressa na memória. Each page is printed when the page in memory is full or when you call PAGE BREAK. To ensure the printing of the last page after any use of Print form, you must conclude with the PAGE BREAK command (except in the context of an OPEN PRINTING JOB, see note). Otherwise, if the last page is not full, it stays in memory and is not printed.

Warning: If the command is called in the context of a printing job opened with OPEN PRINTING JOB, you must NOT call PAGE BREAK for the last page because it is automatically printed by the CLOSE PRINTING JOB command. Se você chamar PAGE BREAK nesse caso, uma página em branco será impressa.

This command prints external areas and objects (for example, 4D Write or 4D View areas). The area is reset for each execution of the command.

Warning: Subforms are not printed with Print form. Para imprimir apenas um formulário com esses objetos, use PRINT RECORD em vez disso.

Print form gera apenas um evento On Printing Detail para o método formulário.

4D Server: This command can be executed on 4D Server within the framework of a stored procedure. Neste contexto:

  • Make sure that no dialog box appears on the server machine (except for a specific requirement).
  • In the case of a problem concerning the printer (out of paper, printer disconnected, etc.), no error message is generated.

Exemplo 1​

O exemplo a seguir funciona como um comando [PRINT SELECTION] (../commands-legacy/print-selection.md). However, the report uses one of two different forms, depending on whether the record is for a check or a deposit:

 QUERY([Register]) // Select the records
 If(OK=1)
    ORDER BY([Register]) // Sort the records
    If(OK=1)
       PRINT SETTINGS // Display Printing dialog boxes
       If(OK=1)
          For($vlRecord;1;Records in selection([Register]))
             If([Register]Type ="Check")
                Print form([Register];"Check Out") // Use one form for checks
             Else
                Print form([Register];"Deposit Out") // Use another form for deposits
             End if
             NEXT RECORD([Register])
          End for
          PAGE BREAK // Make sure the last page is printed
       End if
    End if
 End if

Exemplo 2​

Consulte o exemplo do comando SET PRINT MARKER.

Exemplo 3​

This form is used as dialog, then printed with modifications:

The form method:

 If(Form event code=On Printing Detail)
    Form.lastname:=Uppercase(Form.lastname)
    Form.firstname:=Uppercase(Substring(Form.firstname;1;1))+Lowercase(Substring(Form.firstname;2))
    Form.request:=Lowercase(Form.request)
 End if

The code that calls the dialog then prints its body:

 $formData:=New object
 $formData.lastname:="Smith"
 $formData.firstname:="john"
 $formData.request:="I need more COFFEE"
 $win:=Open form window("Request_obj";Plain form window;Horizontally centered;Vertically centered)
 DIALOG("Request_obj";$formData)
 $h:=Print form("Request_var";$formData;Form detail)

Veja também​

CANCEL
PAGE BREAK
PRINT SETTINGS
SET PRINT OPTION

Propriedades​

Número de comando5
Thread safe✗