skip

Skip the specified number of lines when printing.

skip  {Expression}

Example: skip 2

Parameters

Parameters
Parameter Data Type Description
Expression String Number of lines to skip; must be a whole non-negative number. The value will be truncated to form an integer value. If omitted or 0, one line is skipped.

Return Values

Values returned in $status
Value Meaning
<0 An error occurred. $procerror contains the exact error.
>=0 Statement executed successfully
Values Commonly Returned by $procerror Following skip
Value Error constant Meaning
-1404 <UPROCERR_NO_PRINTING> Not printing (that is, $printing is 0). The skip statement is ignored.

Use

Use in Form and Report components.

Description

The skip statement skips the number of lines defined in Expression.

The following rules are valid for skip:

  • If Uniface is not printing ($printing is 0) when this statement is issued, it is ignored.
  • If the number of lines to be skipped is more than the number of lines left on the page, Uniface issues an eject instead and begins printing again at the top of the following page.
  • When Uniface encounters a skip statement, it is carried out immediately; no other triggers are activated in the current line.

Negative expressions are not supported.

Skipping Lines When Printing

The following example shows ProcScript which causes Uniface to skip two lines if the invoice date in the next occurrence to be printed is not the same as the invoice date in the occurrence just printed. You are advised to test if Uniface is printing ($printing is 1), before using the skip statement, as shown here: 

trigger leavePrinted 
; $printing checks if printing is in process
  if ($printing = 1)
    compare/next (INVDATE) from "INVOICE"
    if ($result = 0)
       skip 2
    endif
  endif
end; leavePrinted

Related Topics