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)