Odkazy v dokumentech 4D Write Pro

Jako vývojáři nebo koncoví uživatelé víte, jak jsou hypertextové odkazy užitečné. Bez nich byste museli znát adresu URL každé stránky na internetu! Umožňují přeměnit text nebo obrázky na odkazy, které umožňují snadný přechod z jednoho místa(např. , dokumentu 4D Write Pro) na jiné (obvykle webové stránky).

Co kdyby odkazy mohly nabídnout víc? Co kdyby mohly spustit provádění kódu 4D nebo jednoduše přesunout kurzor na jinou oblast v tomtéž dokumentu? Mohou!

Pomocí příkazu WP Set attribute můžete do dokumentů vkládat odkazy, ale pouze adresy URL. Nový příkaz WP SET LINK vám umožňuje zadávat i adresy URL (což je jednodušší), ale také vám dává možnost vyvolat metodu z vaší aplikace (s parametry!) nebo cílit záložky z vašeho dokumentu!

ČTYŘI druhy odkazů

• První typy odkazů fungují podobně jako WP Set attributes ($range;wk link url…) s tím rozdílem, že parametrem je nyní místo řetězce objekt.

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

• Druhý typ odkazu umožňuje vytvářet odkazy, které po kliknutí spustí metodu 4D. Metoda může přijímat i textový nebo číselný parametr. Jen se ujistěte, že je metoda nastavena jako „povolená“ pomocí příkazu SET ALLOWED METHODS.

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

• Třetí typ odkazu umožňuje definovat odkazy na externí dokumenty (na disku). Aby bylo možné dokumenty importovat, musí se jednat o dokumenty 4D Write nebo 4D Write Pro. Nahradí aktuální dokument.

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

• Čtvrtý typ odkazu je nový: Odkaz lze nastavit na záložku. Záložka samozřejmě musí být v dokumentu již vytvořena. Po kliknutí na odkaz kurzor automaticky „skočí“ na záložku!

$link:=New object("bookmark"; "chapterOne")
WP SET LINK ($target;$link)

Všimli jste si, že prvním parametrem je cíl? Může to být buď rozsah, nebo jakýkoli jiný platný objekt vašeho dokumentu (například odstavec nebo jakýkoli prvek, například obrázek). To vám výrazně usnadní programování a údržbu!

Nyní, když jsou odkazy nastaveny, pojďme je získat!

Jak jistě tušíte, nový příkaz WP SET LINK má svého sourozence: WP Get links.

Tento příkaz vrátí jediným voláním kolekci všech odkazů v dokumentu. Každý odkaz této kolekce je objekt s popisem odkazu v atributech.

Atributy jsou následující:

link.url (pro odkazy URL)
link .bookmark (pro odkazy na záložky)
link .method (pro odkazy na metody)
link .parameter (pokud existují)
link .range (informace jako .start, .end atd.).

Níže je uveden HDI, který demonstruje všechny tyto možnosti :

Příklad databáze

Další podrobnosti naleznete v centru dokumentace.