WP Table insert columns
WP Table insert columns ( objTarget | {refTabela : Object ; numCol : Integer} {; numColunas : Integer} ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| objTarget | Object | → | Range ou elemento ou documento 4D Write Pro |
| refTabela | Object | → | Referência de tabela |
| numCol | Integer | → | Número da coluna |
| numColunas | Integer | → | Número de colunas a inserir (valor predefinido = 1) |
| Resultado | Object | ← | Range/seleção de colunas da tabela |
Descrição
O comando WP Table insert columns insere uma ou várias colunas em uma tabela 4D Write Pro..
Este comando admite duas sintaxes:
-
Se passar objTarget como primeiro parâmetro, o comando insere as colunas na primeira tabela que intersee 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 intersectar uma tabela a range de texto onde se pode inserir colunas, o comando não faz nada e devolve Null (não se gera um erro).
-
Se passar os parâmetros refTabela e numCol, o comando insere as colunas na tabela designada e no índice de coluna especificado. Se numCol for maior que o número de colunas em refTabela, as colunas se agregam à tabela ao invés de se inserir.
O parâmetro opcional numColunas define o número de colunas a inserir em objTarget ou refTabela. Normalmente, se omitir este parâmetro, se insere uma coluna.
Resultado
O comando devolve uma range de colunas que representa as colunas inseridas, ou Null se não inserir nada.
Exemplo
Para inserir três colunas depois da primeira coluna na tabela Invoice (Faturas). Este código:
var $column : Object
var $table : Object
$table:=WP Get element by ID(WParea;"Invoice") //procura a tabela "Invoice"
$column:=WP Table insert columns($table;2;3) //posição 2, agregue 3 colunas
Insertará as novas colunas na localização correta:
