4D v18
WP Table get 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
WP Table get rows
| WP Table get rows ( targetObj ) | ( tableRef ; startRow {; numRows} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| targetObj | Object |
|
Range or element or 4D Write Pro document | |||||
| tableRef | Object |
|
Table reference | |||||
| startRow | Longint |
|
Position of first row | |||||
| numRows | Longint |
|
Number of rows to get | |||||
| Function result | Object |
|
New table range containing selected rows | |||||
The WP Table get rows command returns a new cell range object containing the selection of rows from targetObj or tableRef (defined by startRow and numRows).
Pass either:
- targetObj:
- 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 a selection of rows can be retrieved, the command returns Null.
OR
- tableRef - the reference of the table whose selection of rows you want to get.
- startRow - points to the first table row to return, and
- (optional) numRows - specifies how many rows to return. If numRows is omitted, the single startRow row is returned.
If startRow plus numRows exceeds the number of rows in tableRef, or if startRow is greater than the number of rows in tableRef, the returned range contains the maximum possible rows.
You want to set a specific background color for the first two rows of a table, and modify the border of the third row:
C_OBJECT($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$rows;$rows2)
$wpRange:=WP Create range(WParea;wk start text;wk end text)
$wpTable:=WP Insert table($wpRange;wk append)
$wpRow1:=WP Table append row($wpTable;"Paul";"Smith";25)
$wpRow2:=WP Table append row($wpTable;"John";"Richmond";40)
$wpRow3:=WP Table append row($wpTable;"Mary";"Trenton";18)
$wpRow4:=WP Table append row($wpTable;"Christopher";"Lee";53)
$wpRow5:=WP Table append row($wpTable;"Henry";"Cartier";42)
$rows:=WP Table get rows($wpTable;1;2)
WP SET ATTRIBUTES($rows;wk background color;0x00E0F0FF)
$rows2:=WP Table get rows($wpTable;3)
WP SET ATTRIBUTES($rows2;wk border style;wk solid)
WP SET ATTRIBUTES($rows2;wk border width;4)
To get a range of rows starting from the 10th to the end:
WP Table get rows(tableRef;10;MAXLONG)You want to retrieve the rows a user has selected:
C_OBJECT($userSelection;$rows)
$userSelection:=WP Selection range(myWPArea)
$rows:=WP Table get rows($userSelection)
WP Insert table
WP Table append row
WP Table get cells
WP Table get columns
Product: 4D
Theme: 4D Write Pro Language
Number:
1475
Created: 4D v16 R4
Modified: 4D v17
Modified: 4D v18
4D Write Pro Reference ( 4D v18)
