WP SET ATTRIBUTES

4D v20

WP SET ATTRIBUTES


WP SET ATTRIBUTES ( faixaObj ; atribNome ; atribValor {; atribNome2 ; atribValor2 ; ... ; atribNomeN ; atribValorN} )

Parâmetro	Tipo	Descrição
faixaObj	Objeto	Range ou elemento de 4D Write Pro documento
atribNome	Texto	Nome do atributo a estabelecer
atribValor	Texto, Número, Objeto, Collection, Imagem, Data	Novo valor do atributo

Descrição

O novo comando WP SET ATTRIBUTES lhe permite estabelecer o valor de qualquer atributo em uma faixa, um elemento ou um documento. Este comando lhe permite acessar a qualquer tipo de atributo interno 4D Write Pro: caractere, parágrafo, documento, tabela ou imagem.

No primeiro parâmetro, pode passar:

uma faixa, ou
um elemento (cabeçalho /rodapé /corpo /tabela /fila /parágrafo /ancorado ou imagem inline/seção-subseção/folha de estilo) ou
um documento 4D Write Pro

Em nomAtrib, passe o nome do atributo a definir para o objetivo e em valorAtrib, passe o novo valor a definir. Para obter uma lista completa dos atributos a passar em nomAtrib, assim como seus respectivos valores, por favor consulte a seção Atributos 4D Write Pro.

Pode passar tantos pares de nomAtrib/ valorAtrib quantos queira.

Nota: se necessitar definir vários atributos para o mesmo objetivo, está otimizado para utilizar uma só chamada a WP SET ATTRIBUTES com todos os pares de atributos/valores, ao invés de chamar várias vezes a WP SET ATTRIBUTES.

Exemplo 1

Nesta área 4D Write Pro, selecione uma palavra:

Se executar o seguinte código:

 $range:=WP Get selection(*;"WParea") //obter a faixa selecionada

 

  // definir o deslocamento da sombra em pt para o texto selecionado

 WP SET ATTRIBUTES($range;wk text shadow offset;1)

  //set the paragraph padding

 WP SET ATTRIBUTES($range;wk padding;1)

  //define uma borda para  10 pt

 WP SET ATTRIBUTES($range;wk border style;wk solid)

 WP SET ATTRIBUTES($range;wk border width;10)

  //define as cores das bordas

 WP SET ATTRIBUTES($range;wk border color;"blue";wk border color bottom;"#00FA9A";wk border color right;"#00FA9A")

Obtem o seguinte resultado:

Exemplo 2

Este exemplo ilustra o uso das constantes wk inside e wk outside:

 $wpRange:=WP Get selection(writeProdoc)

 WP SET ATTRIBUTES($wpRange;wk border style+wk inside;wk dotted)

 WP SET ATTRIBUTES($wpRange;wk border style+wk outside;wk solid)

 WP SET ATTRIBUTES($wpRange;wk border color+wk outside;"#00FA9A")

Supondo que todo o conteúdo foi selecionado, o resultado é:

Exemplo 3

Se qioser estabelecer uma imagem de fundo para o documento:

 C_OBJECT(WParea)

 WParea:=WP New

 

 READ PICTURE FILE("C:\\Pictures\\boats.jpg";$picture)

 

 WP SET ATTRIBUTES(WParea;wk background image;$picture)

O resultado é:

Se quiser estabelecer uma imagem de fundo que cubra toda a área de impressão:

 C_OBJECT(WParea)

 WParea:=WP New

 

 READ PICTURE FILE("C:\\Pictures\\boats.jpg";$picture)

 

 WP SET ATTRIBUTES(WParea;wk background image;$picture)

 WP SET ATTRIBUTES(WParea;wk background clip;wk paper box)

 WP SET ATTRIBUTES(WParea;wk background origin;wk paper box)

O resultado é:

Nota: O valor de paper box é aplicável apenas aos documentos e seções.

Exemplo 4

Se quiser estabelecer abas em intervalos variados e criar caracteres diferentes como o caractere inicial

 $tab1:=New object()

 $tab1[wk type]:=wk left

 $tab1[wk offset]:="3cm"

 $tab1[wk leading]:=""

 

 $tab2:=New object()

 $tab2[wk type]:=wk center

 $tab2[wk offset]:="8cm"

 $tab2[wk leading]:=""

 

 $tab3:=New object()

 $tab3[wk type]:=wk right

 $tab3[wk offset]:="12cm"

 $tab3[wk leading]:="."

 

 $_tabs:=New collection($tab1;$tab2;$tab3)

 WP SET ATTRIBUTES(wpArea;wk tabs;$_tabs)

O resultado é:

Ver também

Atributos 4D Write Pro
WP GET ATTRIBUTES
WP RESET ATTRIBUTES