WP GET ATTRIBUTES

4D v20

WP GET ATTRIBUTES


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

Parâmetro	Tipo	Descrição
faixaObj	Objeto	Faixa do 4D Write Pro ou documento
nomeAtrib	Texto	Nome do atributo a obter
valorAtrib	Texto, 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