WP Table get columns
WP Table get columns ( objTarget ) | ( tabREf ; colInicio {; numCol} ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| objTarget | Object | → | Range ou elemento ou documento 4D Write Pro |
| tabREf | Object | → | objeto referencia tabela |
| colInicio | Integer | → | posição da primeira coluna |
| numCol | Integer | → | numero de colunas a obter |
| Resultado | Object | ← | 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.
Ou
- 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:
var $wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$cols : Object
$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:
var $userSelection;$columns : Object
$userSelection:=WP Selection range(myWPArea)
$columns:=WP Table get columns($userSelection)