VP ADD STYLESHEET

4D v19

VP ADD STYLESHEET


VP ADD STYLESHEET ( nomeAreaVP ; nomeEstilo ; objEstilo {; alcance} )

Parâmetro	Tipo	Descrição
nomeAreaVP	Texto	nome de objeto área formulário 4D View Pro
nomeEstilo	Texto	Nome do estilo
objEstilo	Objeto	Objeto definindo configurações atributo
alcance	Inteiro longo	Escopo do alvo (padrão - folha atual)

Descrição

O comando VP ADD STYLESHEET cria ou modifica a folha de estilo nomeEstilo em função da combinação das propriedades especificadas em styleObj no documento aberto. Se já existir uma folha de estilo com o mesmo nome e alcance no documento, este comando o sobrescreverá com os novos valores.

Nota: as folhas de estilo criadas por este comando são guardadas com o documento.

Em nomeAreaVP, passe o nome da área 4D View Pro. Se passar um nome que não existe, se devolve um erro.

O parâmetro nomeEstilo lhe permite atribuir um nome à folha de estilo. Se o nome já for utilizado dentro do mesmo alcance/escopo, a nova folha de estilo substitui a existente. Lembre que pode utilizar o mesmo nome para diferentes alcances (ver abaio).

Dentro de objEstilo, designe a configuração da folha de estilo (por exemplo, fonte, decoração de texto, alinhamento, bordas, etc.). Pode ver a lista completa de propriedades na página Objetos Estilo 4D View Pro e Folhas de Estilo. Para saber mais sobre os objetos de estilo e as folhas de estilo, consulte Objetos Estilo 4D View Pro e Folhas de Estilo.

Pode determinar onde definir a folha de estilo no parâmetro opcional alcance utilizando o índice de folha (a contagem começa em 0) ou com as constantes abaixo:

Constante	Valor	Comentário
vk current sheet	-1	Determina a folha atual de área 4D View Pro (padrão)
vk workbook	-2	Determina toda a folha de área 4D View Pro.

Se uma folha de estilo nomeEstilo for definida no nivel de livro de trabalho e a nivel de folha, o nivel de folha tem prioridade sobre o nivel de livro de trabalho quando definir a folha de estilo.

Para aplicar a folha de estilo, utilize os comandos VP SET DEFAULT STYLE ou VP SET CELL STYLE.

Exemplo

O código abaixo:

 $styles:=New object

 $styles.backColor:="green"

 

  //Objeto linha borda

 $borders:=New object("color";"green";"style";vk line style medium dash dot)

 

 $styles.borderBottom:=$borders

 $styles.borderLeft:=$borders

 $styles.borderRight:=$borders

 $styles.borderTop:=$borders

 

 VP ADD STYLESHEET("ViewProArea";"GreenDashDotStyle";$styles)

  //Para aplicar o estilo

 VP SET CELL STYLE(VP Cells("ViewProArea";1;1;2;2);New object("name";"GreenDashDotStyle"))

criará o objeto abaixo de estilo chamado GreenDashDotStyle:

{
backColor:green,
borderBottom:{color:green,style:10},
borderLeft:{color:green,style:10},
borderRight:{color:green,style:10},
borderTop:{color:green,style:10}
}

Ver também

Objetos Estilo 4D View Pro e Folhas de Estilo
VP Get stylesheet
VP Get stylesheets
VP REMOVE STYLESHEET
VP SET CELL STYLE
VP SET DEFAULT STYLE