PV GET BORDER COLUMN RANGES

4D v15


PV GET BORDER COLUMN RANGES ( area ; esq ; sup ; dir ; inf ; tiposBorde ; coresBorde )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
esq	Array inteiro longo	Array de números de colunas para células esquerdas
sup	Array inteiro longo	Array dos números de fila para as células superiores
dir	Array inteiro longo	Array dos números das colunas para as células a direita
inf	Array inteiro longo	Array dos números de fila para as células inferiores
tiposBorde	Array inteiro longo	Array de tipos de borde
coresBorde	Array inteiro longo	Array de cores de borde

Descrição

Originalmente introduzido em 4D v14 R4

Tema: PV Borders

O novo comando PV GET BORDER COLUMN RANGES devolve uma lista de faixas que descrevem as células que compartilham o mesmo estilo de borde esquerdo (um estilo de borde consiste de um tipo e de uma cor).

Cada faixa se devolve através de arrays sincronizados esq, sup, dir e inf, onde cada elemento representa, respectivamente os números de célula da faixa, esquerda, acima, direita e abaixo.

Os estilos de bordes correspondentes se devolvem nos parâmetros array tiposBorde e coresBorde:

os valores tiposBorde se podem comparar com as constantes do tema PV Estilo de borde:

Constante	Tipo	Valor
pv border style 1	Inteiro longo	1
pv border style 111	Inteiro longo	7
pv border style 112	Inteiro longo	9
pv border style 2	Inteiro longo	2
pv border style 211	Inteiro longo	8
pv border style 212	Inteiro longo	10
pv border style 222	Inteiro longo	11
pv border style 232	Inteiro longo	12
pv border style 3	Inteiro longo	3
pv border style 4	Inteiro longo	4
pv border style 5	Inteiro longo	5
pv border style 6	Inteiro longo	6
pv border style half	Inteiro longo	14
pv border style none	Inteiro longo	0
pv border style quarter	Inteiro longo	13

os valores coresBorde são de tipo BGR inteiro longo. Para obter mais informação, consulte o comando PV Color to index PV Color to index

Este comando deve ser usado em conjunto com o novo comando PV GET BORDER ROW RANGES para obter uma definição completa dos bordes em sua área, que é útil por exemplo quando se quer exportar uma área 4D View em formato MS Excel.

Nota: a lista de faixas devolvidas pelo comando depende da forma em que as faixas se definiram. Por exemplo, se foi desenhada uma linha vertical, enquanto selecionava a faixa (1B;5B), o comando só devolve um valor correspondente a faixa (1B;5B). No entanto, se traçar uma linha vertical na coluna B e logo fazer um laço sobre as linhas 1 a 5, o comando devolve cinco valores correspondentes a cada interação do laço. O resultado é visualmente idêntico, mas a informação armazenada na área é diferente.

Exemplo

Sua área contém os seguintes bordes:

Se executar este código:

PV GET BORDER COLUMN RANGES(myArea;LeftArray;TopArray;RightArray;BottomArray;BorderTypeArray;BorderColorArray)

Duas faixas serão detectadas, portanto seus arrays conterão os seguintes valores:

LeftArray	TopArray	RightArray	BottomArray	BorderTypeArray	BorderColorArray
2	3	2	4	3	15597568
4	3	4	4	3	15597568

Ver também

PV GET BORDER ROW RANGES