WP CREATE BOOKMARK

4D v17

WP CREATE BOOKMARK


WP CREATE BOOKMARK ( targetObj ; bkName )

引数	型	説明
targetObj	Object	4D Write Pro レンジまたは要素の参照
bkName	文字	作成するブックマーク名

説明

WP CREATE BOOKMARKコマンドは、親ドキュメント内の targetObj 引数で指定された4D Write Proオブジェクトに基づいた、bkName 引数で指定された名前の新しいブックマークを作成します。

ブックマークとはレンジや参照への命名された参照で、これによって例えばテンプレート目的などでドキュメントの特定の部分にアクセスして再利用することができるようになります。詳細な情報については、ブックマークコマンドの章を参照してください。

targetObj 引数には、以下のものを渡すことができます:

レンジ
要素 (本文 / テーブル / 行 / インラインピクチャー / 段落) の参照

注: 要素の参照をtargetObj 引数に渡した場合、ブックマークはその指定された要素のみを含みます。

bkName 引数には新しいブックマークの名前を渡して下さい。ブックマーク名はHTML/CSS名に準拠している必要があります(スペース文字などの無効な文字は自動的に削除されます)。ブックマーク名はドキュメント内において固有でなければなりません。同じ名前のブックマークが既にドキュメント内に存在していた場合、それは上書きされます。

ブックマークは同一ドキュメント内において無制限に作成することができます。同一のレンジを使用した複数のブックマークを作成することもできます。作成したあとは、ブックマークは自動的に親ドキュメントに保存され、そのドキュメント自身と共に保存されます。

例題 1

ドキュメント内で現在選択されているテキストを参照する新しいブックマークを作成したい場合を考えます。以下のように書く事ができます:

 C_OBJECT($range)

 $range:=WP Get selection(*;"WPDocument")

 WP CREATE BOOKMARK($range;"my_bookmark")

例題 2

既存のブックマークの名前を変更したい場合を考えます。そのためには、同じレンジを使用した新しいブックマークを作成し、古い方を削除する必要があります:

 C_TEXT($bookmarkOldName)

 C_TEXT($bookmarkNewName)

 C_LONGINT($p)

 C_OBJECT($wpRange)

 

 $bookmarkOldName:="MyBookmark"

 $bookmarkNewName:="MyNewBookmark"

 

 ARRAY TEXT($_bookmarks;0)

 WP GET BOOKMARKS(WParea;$_bookmarks)

 

 $p:=Find in array($_bookmarks;$bookmarkOldName)

 If($p>0)

    $wpRange:=WP Get bookmark range(WParea;$bookmarkOldName)

    WP DELETE BOOKMARK(WParea;$bookmarkOldName)

    WP CREATE BOOKMARK($wpRange;$bookmarkNewName)

 End if

参照

WP DELETE BOOKMARK
WP Get bookmark range
WP GET BOOKMARKS