Saltar para o conteúdo principal
Versão: Próximo

WP GET ATTRIBUTES

WP GET ATTRIBUTES ( faixaObj ; nomeAtrib ; valorAtrib {; nomeAtrib2 ; valorAtrib2 ; ... ; nomeAtribN ; valorAtribN} )

ParâmetroTipoDescrição
faixaObjObject→Faixa do 4D Write Pro ou documento
nomeAtribText→Nome do atributo a obter
valorAtribTexto, Número, Array, Collection, Imagem, Data🡘Valor atual do atributo para a faixa de texto

Descrição​

O novo comando WP GET ATTRIBUTES devolve o valor de qualquer atributo em uma faixa ou documento 4D Write Pro. Este comando lhe permite acessar a todo tipo de atributos internos 4D Write Pro: caractere, parágrafo, documento, tabela ou imagem.

No rangoObj,o, pode passar:

  • uma range (faixa de seleção)

  • um elemento de referência (cabeçalho / rodapé / corpo / tabela / parágrafo / imagem ancorada ou inline/seção/subseção/folha de estilo), ou

  • um documento 4D Write Pro

Para obter uma lista completa dos atributos a passar em nomAtrib, assim como também seus respectivos valores, por favor consulte a seção Atributos 4D Write Pro.

Se houver diferentes valores para o mismo atributo na faixa ou o documento passado como parâmetro, o comando devolve:

  • para valores numéricos, wk mixed
  • para um array, um array vazio (paradas de tabulações, cor se valorAttib estiver definido como array), com a exceção de wk text shadow offset para o qual o valor array sempre conterá 2 entradas que podem ser definidas por separado como wk mixed se qualquer deslocamento horizontal ou vertical (ou ambos) são combinados.
  • para valores string, uma sting vazia
  • para valores imagem, uma imagem vazia.

Nota: se rangeObj conter um parágrafo e uma folha de estilo de caracteres, se devolve o nome da folha de estilo de parágrafo.

Exemplo​

Se quiser obter a cor de fundo da área selecionada:

 $range:=WP Selection range(*;"WParea")
 WP GET ATTRIBUTES($range;wk background color;$bcol)

Ver também​

Atributos 4D Write Pro
Constantes 4D Write Pro
WP RESET ATTRIBUTES
WP SET ATTRIBUTES