WP Get links
WP Get links ( targetObj ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| targetObj | Object | → | レンジまたは要素または4D Write Proドキュメント |
| 戻り値 | Collection | ← | リンクのコレクション |
説明
WP Get links はtargetObj 引数内のターゲットオブジェクトで定義されている全てのリンクのコレクションを返します。
targetObj 引数には、以下のものを渡すことができます:
- レンジ
- 要素(テーブル/行/段落/本文/ヘッダー/フッター/セクション/サブセクション/テキストボックス)
- 4D Write Pro ドキュメント
返される値
WP Get links はリンクオブジェクトのコレクションを返し、それぞれのオブジェクトには以下のプロパティが1つ、あるいは複数格納されています:
| プロパティ | 型 | 詳細 | 利用可能なリンクの種類 |
|---|---|---|---|
| [ ].url | テキスト | リンクのターゲットのコンテンツ | URLリンク |
| [ ].method | テキスト | リンクのメソッド名 | メソッドリンク |
| [ ].parameter | テキスト | 数値 | リンクに渡される引数値 | メソッドリンク(引数を使っていれば) |
| [ ].bookmark | テキスト | リンクのブックマーク名 | ブックマークリンク |
| [ ].range | オブジェクト | リンクのラベルのレンジ。セレクションレンジコマンド参照。 | 全てのリンク |
例題
4D Write Pro ドキュメント内の全てのURL リンクラベルのカラーを変えたい場合を考えます:
var $links : Collection
var $link : Object
$links:=WP Get links(myDoc)
For each($link;$links)
If($link.url#Null) //URLリンクであれば
WP SET ATTRIBUTES($link.range;wk text color;"red")
End if
End for each