WP GET ATTRIBUTES

4D v16

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	String	Nome do atributo a obter
valorAtrib	String, Real, Booleano, Array	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 ou imagem.

No primeiro parämetro, pode passar seja uma faixa objeto 4D Write Pro (faixaObj) ou uma referência de documento 4D Write (wpDoc). Uma faixaObj è uma parte de um documento 4D Write Pro que pode ser criado pelos diferentes comandos. A seguinte tabela oferece o alcance do comando WP GET ATTRIBUTES em função do parâmetro objeto de destino e os atributos:

Parâmetro	Atributos comuns (exceto "verticalAlign")	Atributos documento unicamente	Atributos parágrafo unicamente	Atributos caractere unicamente (e "verticalAlign")
rangoObj desde WP Get paragraphs	parágrafos	documento	parágrafos	parágrafos
rangoObj desde WP Get pictures	imagens	documento	-	-
rangoObj desde WP Get range ou	parágrafos para a faixa	documento	parágrafos para a faixa (interceptando parágrafos)	caracteres para a faixa
wpDoc	documento	documento	parágrafos para todo o documento	caracteres para todo o documento

Atributos comuns (como "margem", "preenchimento", etc.) são comuns ao documento, parágrafos, e/ou imagens.

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 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.

Exemplo

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

 $range:=WP Get selection(*;"WParea")

 WP GET ATTRIBUTES($range;wk background color;$bcol)

Ver também

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