4D v18
WP Table insert rows
- 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 Bookmark range
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE STYLE SHEETNew
- WP DELETE SUBSECTION
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get frame
- WP Get header
- WP Get links
- WP Get page count
- WP Get position
- WP Get section
- WP Get sections
- WP Get style sheetNew
- WP Get style sheetsNew
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import document
- WP IMPORT STYLE SHEETSNew
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP NEW BOOKMARK
- WP New footer
- WP New header
- WP New style sheetNew
- WP New subsection
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNSNew
- WP TABLE DELETE ROWSNew
- WP Table get cellsUpd
- WP Table get columnsUpd
- WP Table get rowsUpd
- WP Table insert columnsNew
- WP Table insert rowsNew
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- 4D Write Pro Attributes
4D v18
WP Table insert rows
WP Table insert rows
| WP Table insert rows ( targetObj | {tableRef ; rowNumber} {; numRows} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| targetObj | Object |
|
Range or element or 4D Write Pro document | |||||
| tableRef | Object |
|
Table reference | |||||
| rowNumber | Longint |
|
Row index number | |||||
| numRows | Longint |
|
Number of rows to insert (default value = 1) | |||||
| Function result | Object |
|
Range of table rows | |||||
The WP Table insert rows command inserts one or several row(s) into a 4D Write Pro table.
This command supports two syntaxes:
- If you pass a targetObj as the first parameter, the command will insert the row(s) in the first table intersecting the target. targetObj can contain:
- a range, or
- an element (row / paragraph / body / header / footer / inline picture / section / subsection), or
- a 4D Write Pro document.
If targetObj does not intersect with a table or text range where rows can be inserted, the command does nothing and returns Null (no error is generated).
- If you pass both a tableRef and a rowNumber as parameters, the command will insert the row(s) in the designated table and at the specified row index. If the rowNumber is higher than the number of rows in tableRef, the rows are appended to the table rather than inserted.
The optional numRows parameter defines the number of rows to insert into targetObj or tableRef. By default, if this parameter is omitted, one row is inserted.
Result
The command returns a row range representing inserted row(s), or Null if nothing was inserted.
You want to insert two rows at the end of the Invoice table:
C_OBJECT($row)
C_OBJECT($table;$row)
C_LONGINT($rowNum)
$table:=WP Get element by ID(WParea;"Invoice") //retrieve "Invoice" table
If($table#Null)
$rowNum:=$table.rowCount+1 //add 1 to last row to designate where to insert rows
$row:=WP Table insert rows($table;$rowNum;2)
End if
will insert the two new rows at the correct location:
See also
PROPERTIES
Product: 4D
Theme: 4D Write Pro Language
Number:
1691
HISTORY
Created: 4D v18
ARTICLE USAGE
4D Write Pro Reference ( 4D v18)
© 1985-2020 4D SAS / 4D, Inc. All rights reserved.