VP SET BORDER

4D v19

VP SET BORDER


VP SET BORDER ( objRange ; objEstiloBorda ; objPosBorda )

Parâmetro	Tipo	Descrição
objRange	Objeto	objeto Range (faixa de seleção)
objEstiloBorda	Objeto	objeto que contém o estilo da linha borda
objPosBorda	Objeto	Objeto que contém a posição da borda

Descrição

O comando VP SET BORDER aplica os estilos de borda definidos em objEstiloBorda e objPosBorda a range definida em objRange.

Em objRange, passe uma range (faixa de seleção) de células onde se aplicará o estilo de borda. Se a objRange conter várias células, as bordas aplicadas com VP SET BORDER se aplicarão ao objRange como um todo (contrário ao comando VP SET CELL STYLE que aplica bordas a cada célula do objRange). Se já tiver aplicado uma folha de estilo, VP SET BORDER anulará a configuração de borda aplicada anteriormente para objRange.

O parâmetro objEstiloBorda lhe permite definir o estilo das linhas de borda. O objEstiloBorda é compatível com as propriedades abaixo:

Propriedade	Tipo	Descrição	Valores possíveis
color	texto	Define a cor da borda. Como padrão = negro.	Sintaxe de cor CSS "#rrggbb" (sintaxe preferencial), Sintaxe de cor CSS "rgb(r,g,b)" (sintaxe alternativa), nome de cor CSS (sintaxe alternativa)
style	inteiro longo	Define o estilo de borda. Como padrão = vazio.	vk line style dash dot, vk line style dash dot dot, vk line style dashed, vk line style dotted, vk line style double, vk line style empty, vk line style hair, vk line style medium, vk line style medium dash dot, vk line style medium dash dot dot, vk line style medium dashed, vk line style slanted dash dot, vk line style thick, vk line style thick

Pode definir a posição de objEstiloBorda (ou seja, onde aplicar a linha) com o objPosBorda:

Propriedade	Tipo	Descrição
all	booleano	Estilo de linha de borde aplicado a todas as bordas.
left	booleano	Estilo de linha de borde aplicada a borda esquerdo.
top	booleano	Estilo de linha de borde aplicado a borda superior.
right	booleano	Estilo de linha de borde aplicada a borda direita.
bottom	booleano	Estilo de linhade borde aplicado a borda inferior.
outline	booleano	Estilo de linhade borde aplicada apenas às bordas exteriores.
inside	booleano	Estilo de linhade borde se aplica apenas às bordas interiores.
innerHorizontal	booleano	O estilo de linha de borda se aplica apenas às bordas horizontais internas.
innerVertical	booleano	Estilo de linha de borda aplicada apenas às bordas verticais internas.

Exemplo 1

Este código:

 $border:=New object("color";"red";"style";vk line style thick)

 $option:=New object("outline";True)

 VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

produz a borde abaixo ao redor de toda a range:

Exemplo 2

Este código:

  // Define as bordas utilizando VP SET BORDER

 $border:=New object("color";"red";"style";vk line style thick)

 $option:=New object("outline";True)

 VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

 

  // // Define as bordas utilizando VP SET CELL STYLE

 $cellStyle:=New object

 $cellStyle.borderBottom:=New object("color";"blue";"style";vk line style thick)

 $cellStyle.borderRight:=New object("color";"blue";"style";vk line style thick)

 VP SET CELL STYLE(VP Cells("ViewProArea";4;4;3;3);$cellStyle)

demostra a diferença entre VP SET BORDER e a configuração de bordas com o comando VP SET CELL STYLE.

Ver também

VP SET CELL STYLE