WP Table insert rows

4D v19


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

Descrição

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.

Exemplo

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 if

Insere as duas filas novas na localização corrcta:

Ver também

WP Table insert columns