PV GET BORDER ROW RANGES

4D View v16


PV GET BORDER ROW RANGES ( area ; esq ; sup ; dir ; inf ; tiposBordes ; coresBordes )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
esq	Array inteiro longo	Array dos números de colunas das células da esquerda
sup	Array inteiro longo	Array dos números de linhas das células superiores
dir	Array inteiro longo	Array dos números de colunas das células a direita
inf	Array inteiro longo	Array dos números de linhas das células inferiores
tiposBordes	Array inteiro longo	Array de tipos de bordes
coresBordes	Array inteiro longo	Array de cores de bordes

Descrição

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

Cada faixa se devolve por meio de arrays sincronizados esq, sup, dir e inf, onde cada elemento representa, respectivamente, as células a esquerda, superior, direita e inferior da faixa.

Os estilos de bordes correspondentes se devolvem nos parâmetros tiposBordes e coresBordes:

os valores tiposBordes podem ser comparados 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 coresBordes são inteiros longos de tipo BGR. Para obter mais informação, consulte o comando PV Color to index.

Este comando deve ser usado em conjunto com o comando PV GET BORDER COLUMN RANGES para obter uma definição completa dos bordes em sua área, que é útil por exemplo quando 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 horizontal, enquanto selecionava a faixa (4A;4E), o comando só devolve um valor correspondente a faixa (4A;4E). No entanto, se traçar uma linha horizontal na linha 4 e logo fazer um laço sobre as colunas A a E, 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 ROW RANGES(myArea;LeftArray;TopArray;RightArray;BottomArray;BorderTypeArray;BorderColorArray)

Se detectarão quatro rangos, portanto seus arrays contém os seguintes valores:

LeftArray	TopArray	RightArray	BottomArray	BorderTypeArray	BorderColorArray
2	3	3	3	3	15597568
2	5	3	5	3	15597568
3	8	4	8	9	39168
2	9	4	9	2	255

Ver também

PV GET BORDER COLUMN RANGES