Links in 4D Write Pro Dokumenten

Als Entwickler oder Endbenutzer wissen Sie, wie praktisch Hyperlinks sein können. Ohne sie müssten Sie die URL für jede Seite im Internet kennen! Mit ihnen können Sie Ihren Text oder Ihre Bilder in Links umwandeln, um einen einfachen Übergang von einem Ort(z. B. einem 4D Write Pro Dokument) zu einem anderen (in der Regel einer Website) zu ermöglichen.

Was wäre, wenn Links mehr bieten könnten? Was wäre, wenn sie die Ausführung von 4D Code starten oder einfach den Cursor zu einem anderen Bereich im selben Dokument bewegen könnten? Das können sie!

Mit dem Befehl WP Set attribute können Sie Links in Ihre Dokumente einfügen, allerdings nur URLs. Mit dem neuen Befehl WP SET LINK können Sie ebenfalls URLs setzen (einfacher), aber Sie können auch eine Methode aus Ihrer Anwendung aufrufen (mit Parametern!) oder Lesezeichen aus Ihrem Dokument ansteuern!

VIER Arten von Links

• Der erste Link-Typ funktioniert ähnlich wie WP Set attributes ($range;wk link url…), mit dem Unterschied, dass der Parameter jetzt ein Objekt statt eines Strings ist.

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

• Der zweite Link-Typ ermöglicht die Erstellung von Links, die beim Anklicken eine 4D Methode starten. Die Methode kann sogar einen Text- oder numerischen Parameter erhalten. Vergewissern Sie sich nur, dass die Methode mit dem Befehl SET ALLOWED METHODS als „erlaubt“ eingestellt ist.

$link:=New object("Methode"; "myAlert"; "Parameter"; "Hallo Welt!")
WP SET LINK ($target;$link)

• Der dritte Link-Typ erlaubt die Definition von Links zu externen Dokumenten (auf der Festplatte). Die Dokumente müssen 4D Write oder 4D Write Pro Dokumente sein, damit sie importiert werden können. Sie werden das aktuelle Dokument ersetzen.

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

• Der vierte Link-Typ ist neu: Ein Link kann auf ein Lesezeichen gesetzt werden. Natürlich muss das Lesezeichen bereits in Ihrem Dokument angelegt worden sein. Wenn der Link angeklickt wird, „springt“ der Cursor automatisch zu dem Lesezeichen!

$link:=New object("Lesezeichen"; "KapitelEins")
WP SET LINK ($target;$link)

Haben Sie bemerkt, dass der erste Parameter ein Ziel ist? Es kann entweder ein Bereich oder ein anderes gültiges Objekt Ihres Dokuments sein (wie ein Absatz oder ein Element wie ein Bild). Dadurch wird Ihre Programmierung viel einfacher zu schreiben und zu pflegen sein!

Nun, da die Links gesetzt sind, können wir sie abrufen!

Wie Sie sich denken können, hat der neue Befehl WP SET LINK noch ein Geschwisterchen: WP Get links.

Mit einem einzigen Aufruf gibt dieser Befehl eine Sammlung aller Links in einem Dokument zurück. Jeder Link in dieser Sammlung ist ein Objekt mit einer Beschreibung des Links in seinen Attributen.

Die Attribute sind:

link.url (für URL-Links)
link .bookmark (für Lesezeichen-Links)
link .method (für Methoden-Links)
link .parameter (falls vorhanden)
link .range (Informationen wie .start, .end, usw.)

Nachfolgend finden Sie ein HDI, um all diese Möglichkeiten zu demonstrieren:

Datenbank-Beispiel

Weitere Details finden Sie im Doc Center.