Accesso programmatico agli elementi in 4D Write Pro

4D Write Pro continua a offrire sempre più capacità di programmazione! Supponiamo di voler cambiare programmaticamente lo stile di una tabella, di un paragrafo o di un’immagine in un documento 4D Write Pro esistente. Con 4D v17 è possibile! Ora è possibile accedere a qualsiasi elemento o parte di un documento, tramite la programmazione. Queste parti, chiamate elementi, saranno restituite come una collezione grazie alla funzione WP Get elements o come singolo elemento con la funzione WP Get element by ID funzione.

collezione di elementi

Il comando WP Get elements restituisce un insieme di elementi di qualsiasi tipo (paragrafi, tabelle, immagini, ecc.). Se viene passato un intervallo o un riferimento tipizzato, il comando restituirà un insieme contenente solo elementi del tipo corrispondente (a meno che non sia specificato nel secondo parametro). Altrimenti, il comando restituisce una collezione contenente tutti gli elementi disponibili, indipendentemente dal loro tipo.

Ad esempio:

• Se il primo parametro è un intervallo di un tipo specifico (ad esempio un intervallo di paragrafi), anche gli elementi restituiti saranno paragrafi.
• Se il primo parametro non è specifico (un documento completo o un intervallo eterogeneo), gli elementi restituiti possono essere filtrati con un parametro finale (opzionale).

// 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)

Una volta creata, la collezione può essere analizzata. Ogni elemento è un oggetto che può essere usato come parametro per il comando, WP SET ATTRIBUTES.

Elemento singolo

Il comando WP Get element by ID consente di accedere a un singolo elemento. Nei documenti 4D Write Pro, alcuni elementi hanno ID predefiniti (come le immagini e le tabelle). Quando esistono, questi ID possono essere modificati, mentre quando non esistono possono essere creati. Sapendo questo, il comportamento del comando è abbastanza facile da capire: restituisce un singolo elemento per un dato ID!

Una volta ottenuto l’elemento, è possibile manipolarlo come mostrato di seguito:

$element:=WP Get element by ID(myDoc; "Tabella1")
WP SET ATTRIBUTES ($element;wk border style;wk solid)
WP SET ATTRIBUTES ($element;wk border width; "4px")
WP SET ATTRIBUTES ($element;wk border color; "blu")