4D v20
WP Table insert rows
- Referência 4D Write Pro
-
- Linguagem 4D Write Pro
-
- Sobre objetos 4D Write Pro
- Utilizar os comandos do tema Objeto (Formulários)
- Utilizar os comandos do tema Texto com estilo
- Accessar texto e atributos de imagem por programação
- Constantes 4D Write Pro
- 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
- Atributos 4D Write Pro
WP Table insert rows
| WP Table insert rows ( objTarget | {refTabela ; numLinha} {; numLinhasInserir} ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| objTarget | Objeto |
|
Range ou elemento ou 4D Write Pro | |||||
| refTabela | Objeto |
|
Referência de Tabela | |||||
| numLinha | Inteiro longo |
|
Número índice da linha | |||||
| numLinhasInserir | Inteiro longo |
|
Número de linhas a inserir (valor predeterminado =1) | |||||
| Resultado | Objeto |
|
Range/seleção de linhas da tabela | |||||
O comando WP Table insert rows insere uma ou várias linhas em uma tabela 4D Write Pro.
Este comando é compatível com duas sintaxes:
- Se passar um objTarget como primeiro parâmetro, o comando inserte as linhas na primeira tabela que intersere o target. objTarget pode conter:
- uma range, ou
- um elemento (linha / parágrafo / corpo / cabeçalho / rodapé / imagem inline / seção / subseção), ou
- um documento 4D Write Pro.
Se objTarget não se intersectar com uma tabela ou uma range de texto onde se podem inserir as linhas, o comando não faz nada e devolve Null (não é gerado nenhum erro).
- Se passar os parâmetros refTabela e numLinhas, o comando inserte as linhas na tabela designada e no índice de linha especificado. Se numLinhas for maior que o número de linhas em refTabela, as linhas são anexadas na tabela ao invés de serem inseridas.
O parâmetro opcional numLinhas define o número de linhas a inserir em objTarget ou refTabela. De maneira predeterminada, se omitir este parâmetro, se insere uma linha.
Resultado
O comando devolve uma range de linhas que representa as linhas inseridas ou Null se não inserir nada.
Se quiser inserir duas linhas ao final da tabela Invoice (faturas):
C_OBJECT($row)
C_OBJECT($table;$row)
C_LONGINT($rowNum)
$table:=WP Get element by ID(WParea;"Invoice") //consultar a tabela "Invoice"
If($table#Null)
$rowNum:=$table.rowCount+1 //agregue 1 à última linha para designar onde inserir as linhas
$row:=WP Table insert rows($table;$rowNum;2)
End ifInsere as duas filas novas na localização corrcta:
Produto: 4D
Tema: Linguagem 4D Write Pro
Número
1691
Criado por: 4D v18
Referência 4D Write Pro ( 4D v20)
