4D v20
WP Table insert columns
- 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 COMPUTE FORMULAS
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE PICTURE
- WP DELETE STYLE SHEET
- WP DELETE SUBSECTION
- WP DELETE TEXT BOX
- WP EXPORT DOCUMENTUpd
- WP EXPORT VARIABLEUpd
- WP Find all
- WP Find next
- WP Find previous
- WP FREEZE FORMULAS
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get breaks
- WP Get data context
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get formulas
- 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 sheet
- WP Get style sheets
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import document
- WP IMPORT STYLE SHEETS
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT FORMULA
- 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 sheet
- WP New subsection
- WP New text box
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET DATA CONTEXT
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNS
- WP TABLE DELETE ROWS
- WP Table get cells
- WP Table get columns
- WP Table get rows
- WP Table insert columns
- WP Table insert rows
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- 4D Write Pro Attributes
WP Table insert columns
| WP Table insert columns ( targetObj | {tableRef ; colNumber} {; numColumns} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| targetObj | Object |
|
Range or element or 4D Write Pro document | |||||
| tableRef | Object |
|
Table reference | |||||
| colNumber | Longint |
|
Column number | |||||
| numColumns | Longint |
|
Number of columns to insert (default value = 1) | |||||
| Function result | Object |
|
Range of table columns | |||||
The WP Table insert columns command inserts one or several column(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 column(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 columns can be inserted, the command does nothing and returns Null (no error is generated).
- If you pass both a tableRef and a colNumber as parameters, the command will insert the column(s) in the designated table and at the specified column index. If the colNumber is higher than the number of columns in tableRef, the columns are appended to the table rather than inserted.
The optional numColumns parameter defines the number of columns to insert into targetObj or tableRef. By default, if this parameter is omitted, one column is inserted.
Result
The command returns a column range representing inserted column(s), or Null if nothing was inserted.
You want to insert three columns after first column in the Invoice table. This code:
C_OBJECT($column)
C_OBJECT($table)
$table:=WP Get element by ID(WParea;"Invoice") //retrieve "Invoice" table
$column:=WP Table insert columns($table;2;3) //position 2, add 3 columns
Will insert the new columns at the correct location:
Product: 4D
Theme: 4D Write Pro Language
Number:
1692
Created: 4D v18
4D Write Pro Reference ( 4D v20)
