Collegamenti nei documenti di 4D Write Pro

Come sviluppatore o utente finale, sapete quanto possano essere comodi i collegamenti ipertestuali. Senza di essi, dovreste conoscere l’URL di ogni pagina di Internet! Essi consentono di trasformare il testo o le immagini in collegamenti per consentire una facile transizione da un luogo(ad esempio, un documento di 4D Write Pro) a un altro (in genere un sito web).

E se i link potessero offrire di più? Se potessero lanciare l’esecuzione di codice 4D o semplicemente spostare il cursore in un’altra area dello stesso documento? È possibile!

Con il comando WP Set attribute è possibile inserire collegamenti nei documenti, ma solo agli URL. Il nuovo comando WP SET LINK permette di impostare anche gli URL (in modo più semplice), ma offre anche la possibilità di richiamare un metodo dall’applicazione (con parametri!) o di puntare ai segnalibri dal documento!

QUATTRO tipi di link

• Il primo tipo di collegamento funziona in modo simile a WP Set attributes ($range;wk link url…), tranne che per il fatto che il parametro è ora un oggetto invece di una stringa.

$link:=New object("url"; "www/4d.com")
WP SET LINK ($target;$link)

• Il secondo tipo di collegamento consente di creare collegamenti che, quando vengono cliccati, eseguono un metodo 4D. Il metodo può anche ricevere un parametro di testo o numerico. È sufficiente assicurarsi che il metodo sia impostato come “consentito” con il comando SET ALLOWED METHODS.

$link:=New object("method"; "myAlert"; "parameter"; "Hello world!")
WP SET LINK ($target;$link)

• Il terzo tipo di collegamento consente di definire collegamenti a documenti esterni (su disco). Per essere importati, i documenti devono essere documenti di 4D Write o 4D Write Pro. Essi sostituiranno il documento corrente.

$link:=New object("url"; "HelloWorld.4WP)
WP SET LINK ($range;$link)

• Il quarto tipo di collegamento è nuovo: un collegamento può essere impostato su un segnalibro. Naturalmente, il segnalibro deve essere già stato creato nel documento. Quando si fa clic sul collegamento, il cursore “salta” automaticamente al segnalibro!

$link:=New object("segnalibro"; "capitoloUno")
WP SET LINK ($target;$link)

Avete notato che il primo parametro è un target? Può essere un intervallo o qualsiasi altro oggetto valido del documento (come un paragrafo o un elemento come un’immagine). Questo renderà la programmazione molto più semplice da scrivere e da mantenere!

Ora che i collegamenti sono stati impostati, prendiamoli!

Come si può intuire, il nuovo comando WP SET LINK ha un fratello: WP Get links.

Con una sola chiamata, questo comando restituisce un insieme di tutti i collegamenti presenti nel documento. Ogni collegamento di questa collezione è un oggetto con una descrizione del collegamento nei suoi attributi.

Gli attributi sono:

link.url (per i collegamenti URL)
link .bookmark (per i collegamenti a segnalibri)
link .method (per i collegamenti ai metodi)
link .parameter (se presente)
link .range (informazioni come.start, .end, ecc.)

Di seguito è riportato un HDI per dimostrare tutte queste possibilità:

Esempio di database

Ulteriori dettagli sono disponibili nel doc center.