WP Table get rows

4D v19

WP Table get rows


WP Table get rows ( targetObj ) \| ( refTab ; iniFila {; numFilas} ) -> Resultado

Parâmetro	Tipo	Descrição
targetObj	Objeto	Range or element or 4D Write Pro document
refTab	Objeto	objeto referência de tabela
iniFila	Inteiro longo	Posição início fila
numFilas	Inteiro longo	Número de filas a obter
Resultado	Objeto	Nova faixa de tabela contendo filas selecionadas

Descrição

O comando WP Table get rows devolve um novo objeto de range de células que contenha a seleção das filas de objTarget ou refTabela (definidas por filaIni e numFilas)

Passe:

objTarget:
- uma range ou
- um elemento (fila / parágrafo / corpo / cabeçalho / rodapé / imagem inline / seção / subseção), ou
- um documento 4D Write Pro

Se objTarget não se cruza com uma tabela ou range de texto onde se pode recuperar uma seleção de filas, o comando devolve Null.

refTabela - a referência da tabela cuja seleção de filas que quiser obter.
filaIni - aponta à primeira fila da tabela a devolver e
(opcional) numFilas - especifica quantas filas são devolvidas. Se omitir numFilas, se devolve a fila filaIni.

Se filaIni mais numFilas excederem o número de filas em refTabela, ou se filaIni for maior que o número de filas em refTabela, a range devolvida contém o máximo número de filas possível.

Exemplo 1

Se quiser estabelecer uma cor de fundo específico para as duas primeiras filas de uma tabela e modificar a borda da terceira fila:

 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)

Exemplo 2

Para obter uma faixa de filas começando da décima até o fim:

WP Table get rows(tableRef;10;MAXLONG)

Exemplo 3

Se quiser recuperar as filas que um usuário tiver selecionado:

 C_OBJECT($userSelection;$rows)

 

 $userSelection:=WP Selection range(myWPArea)

 

 $rows:=WP Table get rows($userSelection)

Ver também

WP Insert table
WP Table append row
WP Table get cells
WP Table get columns