Elementos de acesso programático em 4D Write Pro

4D Write Pro continua a oferecer cada vez mais capacidades de programação! Digamos que quer alterar programticamente o estilo de uma tabela, parágrafo, ou imagem num documento existente 4D Write Pro. Com 4D v17, é possível! Agora pode aceder a qualquer elemento ou parte de um documento, por programação. Estas partes, chamadas elementos, serão devolvidas ou como uma colecção graças ao WP Get elements função, ou como um único elemento com WP Get element by ID função.

recolha de elementos

O WP Get elements devolve uma colecção de elementos de qualquer tipo (parágrafos, tabelas, imagens, etc.). Se for passada uma gama ou referência datilografada, o comando devolverá uma colecção contendo apenas elementos do tipo correspondente (a menos que especificado no segundo parâmetro). Caso contrário, o comando devolve uma colecção contendo todos os elementos disponíveis, independentemente do seu tipo.

Por exemplo:

• Se o primeiro parâmetro for um intervalo de um tipo específico (um intervalo de parágrafos, por exemplo), então os elementos devolvidos serão também parágrafos.
• Se o primeiro parâmetro não for específico (um documento completo ou um intervalo heterogéneo), então os elementos devolvidos podem ser filtrados com um parâmetro final (opcional).

// Returns all elements of the document
$allElements:=WP Get elements(wpDoc)

// Returns all table elements of the document
$allTables :=WP Get elements(wpDoc;wk type table)

// Returns all paragraphs of the range
$paragraphCol :=WP Get elements($paragraphRange)

// Returns all paragraphs of the table range
$paragraphCol:=WP Get elements($tableRange;wk type paragraph)

// Returns all the tables of the given range
$someTableCol :=WP Get elements($customRange;wk type table)

Uma vez criada, a colecção pode então ser analizada. Cada elemento é um objecto que pode ser utilizado como parâmetro para o comando, WP SET ATTRIBUTES.

Elemento Único

O WP Get element by ID permite o acesso a um único elemento. Nos documentos 4D Write Pro, alguns elementos têm IDs por defeito (como imagens e tabelas). Quando existem, estes IDs podem ser modificados, e quando não existem, podem ser criados. Sabendo que, o comportamento do comando é bastante fácil de compreender, devolve um único elemento para um dado ID!

Uma vez obtido o elemento, pode manipulá-lo, como se mostra abaixo:

$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; "blue")