4D v17
WP INSERT BREAK
- 4D Write Pro Reference
-
- 4D Write Pro Language
-
- About 4D Write Pro objects
- Using commands from the Objects (Forms) theme
- Using commands from the Styled Text theme
- Accessing document contents by programming
- 4D Write Pro Constants
- WP Add picture
- WP CREATE BOOKMARK
- WP Create paragraph range
- WP Create picture range
- WP Create range
- WP Create table rangeNew
- WP DELETE BOOKMARK
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP Get bookmark range
- WP GET BOOKMARKS
- WP Get element by IDNew
- WP Get elementsNew
- WP Get footer
- WP Get frame
- WP Get header
- WP Get page count
- WP Get positionNew
- WP Get selection
- WP Get textNew
- WP Import document
- WP INSERT BREAKUpd
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET TEXTNew
- WP Table append row
- WP Table get cellsUpd
- WP Table get columnsUpd
- WP Table get rowsUpd
- WP USE PAGE SETUP
- 4D Write Pro Attributes
WP INSERT BREAK
| WP INSERT BREAK ( rangeObj ; breakType ; mode {; rangeUpdate} ) | ||||||||
| Parameter | Type | Description | ||||||
| rangeObj | Object |
|
Range | |||||
| breakType | Longint |
|
Type of break to insert | |||||
| mode | Longint |
|
Insertion mode | |||||
| rangeUpdate | Longint |
|
Range update mode | |||||
The WP INSERT BREAK command inserts a new break of the breakType type in the rangeObj range according to the specified insertion mode and rangeUpdate parameters.
In rangeObj, pass a range.
In breakType, pass one of the following constants from the 4D Write Pro Constants theme to define the type of break to insert:
| Constant | Type | Value | Comment |
| wk column break | Longint | 3 | Column break: inserts a column break |
| wk line break | Longint | 0 | Line break (in the same paragraph) |
| wk page break | Longint | 2 | Page break: defines a new page |
| wk section break | Longint | 1 | Section break: defines a new section |
In the mode parameter, pass a constant to indicate the insertion mode to be used for the break in the destination rangeObj range:
| Constant | Type | Value | Comment |
| wk append | Longint | 2 | Insert contents at end of target |
| wk prepend | Longint | 1 | Insert contents at beginning of target |
| wk replace | Longint | 0 | Replace target contents |
In the optional rangeUpdate parameter, you can pass one of the following constants to specify whether or not the inserted contents are included in the resulting range:
| Constant | Type | Value | Comment |
| wk exclude from range | Longint | 1 | Inserted contents not included in updated range |
| wk include in range | Longint | 0 | Inserted contents included in updated range (default) |
If you do not pass the rangeUpdate parameter, by default the inserted contents are included in the resulting range.
While building invoices, you want to insert page breaks except on the last page:
$nbInvoices:=Records in selection([INVOICE])
For($j;1;$nbInvoices)
... //processing invoices
If($j#$nbInvoices) //insert page break except for last page
WP INSERT BREAK($buildRange;wk page break;wk append;wk exclude from range)
End if
End for
Product: 4D
Theme: 4D Write Pro Language
Number:
1413
Created: 4D v16
Modified: 4D v17
4D Write Pro Reference ( 4D v17)
