4D v17

WP GET ATTRIBUTES

Página Inicial

 
4D v17
WP GET ATTRIBUTES

WP GET ATTRIBUTES 


 

WP GET ATTRIBUTES ( faixaObj ; nomeAtrib ; valorAtrib {; nomeAtrib2 ; valorAtrib2 ; ... ; nomeAtribN ; valorAtribN} ) 
Parâmetro Tipo   Descrição
faixaObj  Objeto in Faixa do 4D Write Pro ou documento
nomeAtrib  Texto in Nome do atributo a obter
valorAtrib  Texto, Número, Array inteiro longo, Array real, Imagem, Data in Valor atual do atributo para a faixa de texto

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 primeiro parâmetro, pode passar:
  • Um objeto (targetObj) que pode ser:uma faixa, ou
        um elemento de referência (cabeçalho / rodapé / corpo / tabela / parágrafo / imagem ancorada ou inline), 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 dewk 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.

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 

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

 
PROPRIEDADES 

Produto: 4D
Tema: Linguagem 4D Write Pro
Número 1345

This command can be run in preemptive processes

 
HISTÓRIA 

Criado por: 4D v15 R4
Modificado: 4D v16 R4
Modificado: 4D Pack v16 R5

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v17)