WP Table get columns

4D v18


WP Table get columns ( objTarget ) \| ( tabREf ; colInicio {; numCol} ) -> Resultado

Parâmetro	Tipo	Descrição
objTarget	Objeto	Range ou elemento ou documento 4D Write Pro
tabREf	Objeto	objeto referencia tabela
colInicio	Inteiro longo	posição da primeira coluna
numCol	Inteiro longo	numero de colunas a obter
Resultado	Objeto	Nova faixa de tabela contendo colunas selecionadas

Descrição

O comando WP Table get columns [#/descv]. devolve um novo objeto de faixa de celulas que contem a seleção de colunas refTabela (definida por colIni e numCol). [#/descv].

Passe:

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

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

refTabela- a referência da tabela cuja seleção de colunas quiser obter.
colIni - aponta à primeira coluna da tabela a devolver e
(opcional) numCol - especifica quantas colunas devolver. Se omitir numCol, se devolve a única coluna colIni.

Se colIni mais numCol exceder o número de colunas em refTabela, ou se colIni for maior que o número de colunas em refTabela, a range devolvida contém o máximo possível de colunas.

Exemplo 1

Se quiser modificar alguns atributos das duas últimas colunas de uma tabela:

 C_OBJECT($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$cols)

 $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)

 

 $cols:=WP Table get columns($wpTable;2;2)

 WP SET ATTRIBUTES($cols;wk background color;0x00E0E0E0;wk text color;"red";wk height;"36pt";wk text align;wk center)

Resultado:

Exemplo 2

Para obter uma faixa de colunas iniciando da décima até o final:

WP Table get columns(tableRef;10;MAXLONG)

Exemplo 3

Se quiser recuperar as colunas que um usuário for selecionado:

 C_OBJECT($userSelection;$columns)

 

 $userSelection:=WP Selection range(myWPArea)

 

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

Ver também

WP Table get cells
WP Table get rows