開発者やエンドユーザーであれば、ハイパーリンクがいかに便利かはご存じでしょう。ハイパーリンクがなければ、インターネット上のすべてのページのURLを知っておく必要があります。ハイパーリンクは、テキストや画像をリンクに変えることで、ある場所(例えば、4D Write Proドキュメント)から別の場所(通常、ウェブサイト)へ簡単に移動することができます。
もし、リンクがもっと多くのことを提供できるとしたらどうでしょうか?もし、リンクが4Dコードの実行を開始したり、同じドキュメント内の別のエリアにカーソルを移動させることができたらどうでしょうか?できるのです。
WP Set attribute コマンドでドキュメントにリンクを挿入することができますが、それはURL のみです。新しいWP SET LINK コマンドは、URL を設定することもできますが(より簡単)、アプリケーションからメソッドを呼び出したり(パラメータ付き!)、ドキュメントからブックマークをターゲットにしたりする機能も備えています!
4種類のリンク
- 最初のリンクはWP Set attributes ($range;wk link url…) と似ていますが、パラメータが文字列ではなく、オブジェクトになっています。
$link:=New object("url"; "www/4d.com")
(
WP SET LINK$target;$link)
- 2つ目のリンクタイプは、クリックすると4Dメソッドを実行するリンクを作成することができます。このメソッドは、テキストや数値のパラメータを受け取ることができます。ただ、SET ALLOWED METHODS コマンドでメソッドが“allowed “に設定されていることを確認してください。
$link:=New object("method"; "myAlert"; "parameter"; "Hello world!")
WP SET LINK (
$target;$link)
- 3番目のリンクタイプは、外部文書(ディスク上)へのリンクを定義することができます。インポートするためには、4D Writeまたは4D Write Proのドキュメントである必要があります。これらは、現在のドキュメントを置き換えます。
$link:=New object("url"; "HelloWorld.4WP")
WP SET LINK (
$range;$link)
- 4つ目のリンクタイプは、 ブックマークへのリンク設定です。もちろん、ブックマークはすでに文書内に作成されている必要があります。リンクがクリックされると、カーソルは自動的にブックマークへ「ジャンプ」します。
$link:=New object("bookmark"; "chapterOne")
(
WP SET LINK$target;$link)
最初のパラメータがターゲットであることにお気づきでしょうか?これは、範囲でも、文書の有効なオブジェクト(段落や画像などの要素)でもかまいません。これにより、プログラミングがより簡単になり、メンテナンスも楽になります。
さて、リンクが設定されたので、それを取得してみましょう。
お察しの通り、新しいWP SET LINK コマンドには兄弟がいます。 WP Get links.
このコマンドは、一度の呼び出しで、ドキュメント内のすべてのリンクのコレクションを返します。このコレクションの各リンクは、その属性にリンクの説明を持つオブジェクトである。
属性は
link.url (URLリンクの場合)
link .bookmark (ブックマークリンクの場合)
link .method (メソッドリンクの場合)
link .parameter (ある場合)
link .range (start、.endなどの情報)
以下は、これらの可能性を示すHDIです。
より詳細な情報は、doc centerをご覧ください。