WP Get element by ID

4D v20 R7


WP Get element by ID ( wpDoc ; ID ) -> Resultado

Parâmetro	Tipo	Descrição
wpDoc	Objeto	Documento 4D Write Pro
ID	String	Identificador do elemento a recuperar
Resultado	Objeto	elemento 4D Write Pro

Descrição

O comando WP Get element by ID devolve um objeto que contenha o elemento de wpDoc passado no parâmetro ID.

No parâmetro wpDoc, passe o documento 4D Write Pro.

Passe o atributo ID do elemento para recuperá-lo no parâmetro ID. O elemento pode estar dentro do documento, como uma imagem, um parágrafo, uma tabela, uma fila, etc., ou o documento em si. Se nenhum elemento do documento tiver a ID especificada, se devolve um valor nulo.

Nota: o valor do parâmetro ID é sensível às maiúsculas e minúsculas.

Exemplo 1

Para obter a imagem com o ID "img1":

 C_OBJECT(obImage)

 obImage:=WP Get element by ID(myDoc;"img1")

Exemplo 2

Se quiser encontrar um elemento de tabela e modificá-lo para que tenha uma borda roxa grande:

 C_OBJECT($element)

 $element:=WP Get element by ID(myDoc;"Table1")

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

 WP SET ATTRIBUTES($element;wk border width;"4px")

 WP SET ATTRIBUTES($element;wk border color;"purple")

Exemplo 3

Se quiser recuperar um elemento e modificar seu ID:

 $colTable:=WP Create table range([INFO]Sample)

 $elements:=WP Get elements($colTable)

 $elem:=WP Get element by ID([INFO]Sample;"Paris")

 If($elem#Null)

    $elem.ID:="Lyon"

 End if

Ver também

WP Get elements