メインコンテンツまでスキップ
バージョン: 20 R10 BETA

WP SET LINK

WP SET LINK ( targetObj ; linkObj )

引数型説明
targetObjObject→レンジまたは要素または4D Write Pro ドキュメント
linkObjObject→ハイパーリンクの値

説明​

WP SET LINK はtargetObj 引数で指定したターゲットオブジェクトに、ハイパーリンク参照を割り当てます。URL、4Dメソッド、そしてブックマークへのリンクがサポートされます。リンクは、ユーザーがそれをクリック(あるいはURLを開くのにテキストが編集可能な場合、Windows ではCtrl+クリック、macOS ではCmd+クリック)をすることでアクションがトリガーされます。

targetObj 引数には、リンクを適用したい4D Write Pro オブジェクトを渡します。以下のものを渡すことができます:

  • レンジ
  • 要素(テーブル / 行 / 段落 / 本文 / ヘッダー / フッター / セクション / サブセクション)
  • 4D Write Pro ドキュメント

例えばヘッダーを渡した場合、ヘッダーのコンテンツ全体がハイパーリンクとして表示されます。ドキュメントにリンクを挿入する場合、4D Write Pro は以下のルールに基づいてリンクを適用します:

  • 複数の段落を含むtargetObj に対してリンクを設定した場合、複数の個別のリンクが定義されます。
  • 既にリンクが適用されているtargetObj に対してリンクを設定した場合:
    • targetObj のターゲットオブジェクト内に完全に含まれている既存のリンクは全て削除され、targetObj には新しいリンクが適用されます。
    • リンクの一部分が選択されていた場合(targetObj と一部交差していた場合)、リンクの範囲は縮小し、選択されていない部分は以前のリンクを保つ一方、targetObj の範囲内には新しいリンクが適用されます。

linkObj 引数には、ハイパーリンクの詳細を格納したオブジェクトを渡します。以下のプロパティのどれか一つだけを格納している必要があります(ただしparameter プロパティはmethod プロパティと同時に併用することが可能です):

引数プロパティ型詳細 1ドル テキスト 4D Write Pro エリア名 2ドル オブジェクト method テキスト 4D メソッド名 parameter テキスト | 数値 parameter プロパティを通してメソッドに送られるユーザー引数(任意、以下参照) range オブジェクト targetObj のレンジ
プロパティ型詳細ハイパーリンクアクション
urlテキストURL型ハイパーリンクのリンク先(エンコードされたURL)。標準のWeb アドレスへの参照(http または https://website、mailto:*abc@xyz.com、*など): デフォルトアプリケーション(一般的にはブラウザ)でURLを開きますファイルパスへの参照(絶対パスあるいは4D ストラクチャーファイルからの相対パス)、または.4wp or .4w7 ファイルへの参照(file://filepath または filepath/file.4wp): ファイルを読み込みカレントのドキュメントを置き換えます。他のファイルタイプを参照していた場合、そのファイルタイプに対するシステムのデフォルトのアプリケーションでそのファイルを開きます。
bookmarkテキストブックマーク名カレントフォキュメント内の指定されたブックマークにアクセスします(ブックマークコマンド参照)
methodテキストプロジェクトメソッド名 - メソッドは存在しかつSET ALLOWED METHODS コマンドで許可されている必要があります。クリックされると4Dメソッドを実行します。メソッドは自動的に二つの引数を1ドルと2ドルに受け取ります:
parameterテキスト | 数値method 型のリンクでのみ使用可能、メソッドが引数を必要としない場合には必須ではありません。メソッドに送るための追加の引数を格納しています。メソッド内の2ドル.parameter に受け取られます

注:

  • 4D Write Pro は有効な(エンコードされた)URL しか受け付けません。リンク内の特殊文字は変換されません。特殊文字(例:スペースは %20 など)が必要な場合は、それらを別途明示的にエンコードする必要があります。リンクが有効でない場合、エラーが生成されます。
  • 4D Write Pro ドキュメントから4D メソッドへのリンクは、ドキュメントがHTML、MIME HTML、あるいは .docx フォーマットに書き出される際に除去されます。
  • targetObj のターゲットオブジェクトからリンクを除去したい場合、リンクコマンド の段落を参照してください。

例題 1​

ウェブサイトへのリンクを、ドキュメントのフッターエリアに追加したい場合を考えます:

 var $footer : Object
 $footer:=WP Get footer(WPArea;1)
 WP SET TEXT($footer;"Please visit our website";wk replace)
 WP SET LINK($footer;New object("url";"http://www.4d.com"))

例題 2​

ドキュメント内での全てのブックマークを使用して、リンクつきの目次ページを作成したい場合を考えます:

 var $i;$n;$p;$memoStart : Integer
 var $range;$link;$toc;$tocRange;$positionInfo;$target : Object
 var $text : Text

 ARRAY TEXT($_bookmarks;0)
 WP GET BOOKMARKS(WParea1;$_bookmarks) //全てのブックマークを検索

 $n:=Size of array($_bookmarks)
 If($n>0)
  $tocRange:=WP Text range(WParea1;wk start text;wk start text) //テキストの開始位置を探す
  WP INSERT BREAK($tocRange;wk page break;wk append;wk exclude from range) //テキストの前に改ページを追加

  For($i;1;$n) // 目次とリンクを挿入
    $range:=WP Bookmark range(WParea1;$_bookmarks{$i})
    $positionInfo:=WP Get position($range)
    $memoStart:=$tocRange.end
    WP SET TEXT($tocRange;Char(Tab)+$_bookmarks{$i}+Char(Tab)+String($positionInfo.page);wk append;wk include in range)

    $target:=WP Text range($tocRange;$memoStart+1;$memoStart+1+Length($_bookmarks{$i}))
    $link:=New object("bookmark";$_bookmarks{$i})
    WP SET LINK($target;$link)
    WP INSERT BREAK($tocRange;wk line break;wk append;wk include in range)
  End for
 End if

例題 3​

ドキュメントの"4D"という文字列にそれぞれ4Dメソッドへのリンクを設定したい場合を考えます:

 var $text,$find : Text
 var $p : Integer
 var $range;$link : Object

 $text:=WP Get text(wpArea;wk expressions as value) //ドキュメント内の全てのテキストを取得

 $find:="4D" //リンクをつけるターゲット

 $p:=Position($find;$text) //ターゲットの出現箇所を全て探すためにテキスト内をループ
 If($p>0)
  $range:=WP Text range(wpArea;$p;$p+Length($find)) //ターゲットの長さを設定
 //create the link object
  $link:=New object("method";"myAlert";"parameter";"4D rocks!") //SET ALLOWED METHODS でメソッドを許可することをお忘れなく

  WP SET LINK($range;$link)
 End if

参照​

WP Get links

AltStyle によって変換されたページ (->オリジナル) /