WP NEW BOOKMARK

Home

4D v20 R7

WP NEW BOOKMARK


WP NEW BOOKMARK ( targetObj ; bkName )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element
bkName	String	Name des zu erstellenden Lesezeichens

Beschreibung

Der Befehl WP NEW BOOKMARK erstellt ein neues Lesezeichen mit Namen bkName, basierend auf dem targetObj von 4D Write Pro im Elterndokument.

Lesezeichen sind Referenzen mit Namen auf "Ranges" oder Referenzen, über die Sie auf bestimmte Teile des Dokuments zugreifen und diese wiederverwenden können, z.B. für Vorlagen. Weitere Informationen dazu finden Sie im Abschnitt Befehle für Lesezeichen.

In targetObj können Sie folgendes übergeben:

"Range" oder
Element (Hauptteil, Tabelle, Zeile, Absatz, Bild im Textfluss)

Hinweis: Haben Sie in targetObj ein Element übergeben, enthält das Lesezeichen nur das angegebene Element.

In bkName übergeben Sie den Namen des neuen Lesezeichens. Er muss sich nach den Kriterien für HTML/CSS Namen richten, z.B. darf er nur alphanumerische Zeichen enthalten; ungültige Zeichen wie Leerzeichen werden automatisch entfernt. Lesezeichennamen müssen innerhalb des Dokuments einmalig sein. Ist bereits ein gleichlautendes Lesezeichen vorhanden, wird es überschrieben.

Sie können im gleichen Dokument beliebig viele Lesezeichen erstellen, auch im gleichen "Range" sind mehrere Lesezeichen möglich. Ist ein Lesezeichen erstellt, wird es automatisch im Elterndokument gespeichert und ist so im Dokument selbst gesichert.

Beispiel 1

Ein neues Lesezeichen mit Referenz auf den aktuell ausgewählten Text im Dokument erstellen. Sie schreiben folgenden Code:

 C_OBJECT($range)

 $range:=WP Selection range(*;"WPDocument")

 WP NEW BOOKMARK($range;"my_bookmark")

Beispiel 2

Ein vorhandenes Lesezeichen umbenennen. Dazu müssen Sie ein neues Lesezeichen mit derselben Reichweite erstellen und dann das alte löschen:

 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 NEW BOOKMARK($wpRange;$bookmarkNewName)

 End if

Siehe auch

Download HDI database
WP Bookmark range
WP DELETE BOOKMARK
WP GET BOOKMARKS