4D v17

WP Table get cells

Página Inicial

 
4D v17
WP Table get cells

WP Table get cells 


 

WP Table get cells ( refTab ; inCol ; iniFila {; numCol {; numFilas}} ) -> Resultado 
Parâmetro Tipo   Descrição
refTab  Objeto in objeto referência de tabela
inCol  Inteiro longo in posição da primeira célula da coluna
iniFila  Inteiro longo in posição da primeira linha da coluna
numCol  Inteiro longo in Número de colunas a obter
numFilas  Inteiro longo in Número de filas a obter
Resultado  Objeto in Nova faixa contendo células

O comando WP Table get cells devolve um noo objeto de faixa de células que contenha a seleção de células refTabela definida por colIni, filaIni, numCol e numFilas.

Os parâmetros colIni e filaIni definem as coordenadas superiores esquerdas da primeira célula a obter. Opcionalmente, pode passar os parâmetros numCol e numFilas para especificar, respectivamente, o número de colunas e o número de filas a obter para a faixa de celulas. Se for omitido numFilas, se devolve uma só fila. Se for omitido numCol e numFilas, a faixa retornada contém uma única célula.

Se colIni mais numCol ou filaIni mais numFilas excedem o número de colunas/filas em refTabela, ou se colIni ou filaIni for maior que o número de colunas/filas em refTabela, se devolve  a faixa que contém o número máximo possível de colunas/filas.

Se quiser modificar os atributos de uma faixa de células:

 C_OBJECT($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$cells)
 $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)
 
 $cells:=WP Table get cells($wpTable;2;2;2;2)
 WP SET ATTRIBUTES($cells;wk background color;0x00E0E0E0)
 WP SET ATTRIBUTES($cells;wk text color;"blue")
 WP SET ATTRIBUTES($cells;wk border color;0x00E000E0)
 WP SET ATTRIBUTES($cells;wk text align;wk center)

Resultado:

Para obter uma faixa de células iniciando da célula "5x7" ao final da fila:

 $cellRange:=WP Table get cells(tableRef;5;7;MAXLONG;1)

Para obter uma faixa de células iniciando da célula "5x7" até o final da coluna:

 $cellRange:=WP Table get cells(tableRef;5;7;1;MAXLONG)

Para obter uma faixa de células iniciando da célula  "5x7" até o final da tabela:

 $cellRange:=WP Table get cells(tableRef;5;7;MAXLONG;MAXLONG)



Ver também 

WP Table get columns
WP Table get rows

 
PROPRIEDADES 

Produto: 4D
Tema: Linguagem 4D Write Pro
Número 1477

This command can be run in preemptive processes

 
HISTÓRIA 

New
Criado por: 4D v16 R4
Modificado: 4D v17

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v17)