WINPRINT-SET-DATA-COLUMNS
The WINPRINT-SET-DATA-COLUMNS function defines the way the buffer is split into columns. When a page is divided into columns (see the
WINPRINT-SET-PAGE-COLUMN function) the program can use a single
WRITE statement to print the content of all columns at a time. You can call this function specifying all character positions or call it repeatedly specifying one character position at a time. Each time this function is called, it adds the values passed to the list that will be used to split information when the
WRITE statement is executed. To clear that list, use the
WINPRINT-CLEAR-DATA-COLUMNS function.
Syntax:
CALL "WIN$PRINTER" USING WINPRINT-SET-DATA-COLUMNS { charPosition } ... GIVING returnCode |
Parameters:
WINPRINT-SET-DATA-COLUMNS | Constant | |
charPosition | any numeric data item or numeric literal | Contains the starting position of a character in the print buffer. If the print buffer is a non-national group item, the most convenient way is to use the RECORD-POSITION syntax, instead of computing values manually. |
Return code:
returnCode can be any signed numeric data item and provides additional information:
1 | Operation successful. |
WPRTERR-UNSUPPORTED | The WIN$PRINTER library routine is not supported. |
WPRTERR-BAD-ARG | The WIN$PRINTER library routine has been called with bad parameters. |