WP CREER SIGNET

4D v20 R7

WP CREER SIGNET


WP CREER SIGNET ( objCible ; nomSignet )

Paramètre	Type	Description
objCible	Objet	Plage ou élément
nomSignet	Chaîne	Nom du signet à créer

Description

La commande WP CREER SIGNET crée un nouveau signet nommé nomSignet basé sur objPlage du document parent.

Les signets sont des références nommées associées à des plages ou à des éléments, vous permettant de désigner et de réutiliser des parties spécifiques du document, par exemple pour les besoins liés à la génération de modèles. Pour plus d'informations, veuillez vous reporter à la section Gestion des signets.

Dans objCible, vous pouvez passer :

une plage 4D Write Pro, ou
un élément (corps / tableau / ligne / image en ligne / paragraphe)

Note : Si vous passez un élément dans objCible, le signet contiendra uniquement l'élément défini.

Dans nomSignet, passez le nom du nouveau signet. Un nom de signet doit être conforme aux règles de nommage HTML/CSS, i.e. il doit uniquement contenir des caractères alphanumériques (les caractères invalides, tels que les espaces, sont automatiquement supprimés). Chaque nom de signet doit être unique dans un document. Si un signet de même nom existe déjà dans le document, il est écrasé.

Vous pouvez créer autant de signets que vous voulez dans un même document. Plusieurs signets peuvent être créés avec la même plage. Une fois créé, un signet est automatiquement stocké dans le document parent et est sauvegardé en même temps que le document lui-même.

Exemple 1

Vous souhaitez créer un nouveau signet référençant le texte couramment sélectionné dans le document. Vous pouvez écrire :

 C_OBJET($range)

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

 WP CREER SIGNET($range;"my_bookmark")

Exemple 2

Vous souhaitez renommer un signet existant. Pour cela, vous devez créer un nouveau signet basé sur la même plage puis supprimer l'ancien :

 C_TEXTE($bookmarkOldName)

 C_TEXTE($bookmarkNewName)

 C_ENTIER LONG($p)

 C_OBJET($wpRange)

 

 $bookmarkOldName:="MyBookmark"

 $bookmarkNewName:="MyNewBookmark"

 

 TABLEAU TEXTE($_bookmarks;0)

 WP LIRE SIGNETS(WParea;$_bookmarks)

 

 $p:=Chercher dans tableau($_bookmarks;$bookmarkOldName)

 Si($p>0)

    $wpRange:=WP Lire plage signet(WParea;$bookmarkOldName)

    WP SUPPRIMER SIGNET(WParea;$bookmarkOldName)

    WP CREER SIGNET($wpRange;$bookmarkNewName)

 Fin de si

Voir aussi

Download HDI database
WP LIRE SIGNETS
WP Plage signet
WP SUPPRIMER SIGNET