WP CREATE BOOKMARK

4D v16

WP CREATE BOOKMARK


WP CREATE BOOKMARK ( rangeObj ; bkName )

引数	型	説明
rangeObj	Object	4D Write Proレンジ
bkName	文字	作成するブックマーク名

説明

WP CREATE BOOKMARKコマンドは、rangeObj 引数で指定されたbkName引数で指定された名前の4D Write Proレンジを、レンジの親ドキュメント内に作成します。

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

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