Codificar um intervalo em 4D View Pro

4D v17 R4 traz novas características ao 4D View Pro e uma delas é a criação de gamas com código.

Primeiro, é necessário definir um objecto de alcance para manipular as suas células através da programação. Pode fazer isto em 4D View Pro com os seguintes novos comandos: VP Cell, VP Cells, VP Column, VP Row, VP All e VP Combine ranges.

Um objecto de gama pode definir:

• uma célula ou um grupo de células,
• uma coluna ou um grupo de colunas,
• uma fila ou um grupo de filas
• todas as células de uma folha.

definir uma célula ou um grupo de células

Para definir as coordenadas de uma única célula, utilize o VP Cell comando:

$column:=3 //column of beginning cell
$row :=5 //row of beginning cell
$sheet :=2 // specific workbook sheet
$cellObj1 :=VP Cell ("ViewProArea";$column;$row) // cell D6 (current sheet)
$cellObj2 :=VP Cell ("ViewProArea";$column;$row;$sheet) // cell D6 sheet 3


Tenha em mente que o índice da linha, o índice da coluna e o índice da folha começam em 0. Assim, as coordenadas da primeira célula superior esquerda são (0;0)!

Um grupo de células é basicamente definido referenciando a célula superior esquerda e a contagem de filas e células. Passar esta informação ao comando VP Cells comando:

$column:=3 //column of beginning cell
$row :=5 //row of beginning cell
$columnCount :=2 // total number of columns
$rowCount :=3 // total number of rows
$sheet :=2 // specific workbook sheet
$cellsObj1 :=VP Cells ("ViewProArea";$column;$row;$columnCount;$rowCount) // cells D6 to E8 (current sheet)
$cellsObj2 :=VP Cells ("ViewProArea";$column;$row;$columnCount;$rowCount;$sheet) // cells D6 to E8 on sheet 3


definir uma coluna ou um grupo de colunas

Para definir a coordenada de uma coluna, passe o índice da coluna para o VP Column comando. Se precisar de definir várias colunas contíguas, adicionar uma contagem de colunas após o índice de colunas:

$column:=3 // beginning column
$columnCount :=2 // total number of columns
$sheet :=2 // specific workbook sheet
$colObj1 :=VP Column ("ViewProArea";$column) // column D (current sheet)
$colObj2 :=VP Column ("ViewProArea";$column;$columnCount) // column D + column E (current sheet)
$colObj3 :=VP Column ("ViewProArea";$column;$columnCount;$sheet) // column D + column E sheet 3

definir uma fila ou um grupo de filas

Para definir as coordenadas de uma linha, passe o índice de colunas para o comando VP Row. Se precisar de definir várias filas contíguas, adicionar uma contagem de filas após o índice de filas:

$row:=5 // beginning row
$rowCount :=3 // total number of rows
$sheet :=2 // specific workbook sheet
$rowObj1 :=VP Row ("ViewProArea";$row) // row 6
$rowObj2 :=VP Row ("ViewProArea";$row;$rowCount) // row 6 + row 7 + row 8
$rowObj3 :=VP Row ("ViewProArea";$row;$rowCount;$sheet) // row 6 + row 7 + row 8 sheet 2

definir um intervalo de células irregulares

Um intervalo irregular de células é quando é necessário combinar vários grupos separados (descontínuos) de células dentro do mesmo intervalo. Para o fazer, criar um intervalo individual para cada grupo contínuo, depois passar todos eles em parâmetro para o VP Combine ranges comando:

$combine:=VP Combine ranges ($cellObj1;$colObj1;$rowObj1;rowObj2;cellsObj2)