WP SET LINK

4D v20 R7

WP SET LINK


WP SET LINK ( objCible ; objLien )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
objLien	Objet	Valeur du lien hypertexte

Description

La commande WP SET LINK applique une référence de lien hypertexte au paramètre objCible. Les liens vers les URL, les méthodes 4D et les signets sont pris en charge. Le lien déclenche une action lorsque l'utilisateur clique dessus (ou lorsqu'il utilise le raccource Ctrl+clic sur Windows ou Cmd+clic sur macOS si le texte n'est pas en lecture seule pour les URL ouvrants).

Dans objCible, passez l'objet 4D Write Pro à l'endroit où le lien sera créé. Vous pouvez passer :

une plage, ou
un élément (tableau / ligne / paragraphe / corps / en-tête / pied / section / sous-section), ou
un document 4D Write Pro

Par exemple, si vous passez un en-tête, tout le contenu de l'en-tête sera affiché sous forme de lien hypertexte. Lorsque vous insérez des liens dans vos documents, 4D Write Pro applique les règles suivantes :

Si vous fixez un lien dans le paramètre objCible qui contient plusieurs paragraphes, plusieurs liens séparés seront définis.
Si vous fixez un lien dans le paramètre objCible qui contient déjà un ou plusieurs liens :
- tous les liens existants qui sont entièrement inclus dans objCible sont supprimés et le nouveau lien s'applique à objCible.
- si un lien est partiellement sélectionné (il croise l'objCible), il est réduit afin que la partie non sélectionnée conserve le lien précédent et que le nouveau lien s'applique à objCible.

Dans le paramètre objLien, passez un objet qui décrit le lien hypertexte. Il ne doit contenir qu'une seule des propriétés suivantes (exceptée la propriété du paramètre, qui peut être utilisée avec la propriété de la méthode) :

Propriété

Type

Description

Action du lien hypertexte

url

Texte

Destination du lien hypertexte d'un type d'URL (url crypté).

Crée un lien vers une adresse web standard (http ou https://website, mailto:abc@xyz.com, etc.) : ouvre l'URL dans l'application par défaut (généralement dans un navigateur)
Crée un lien vers un chemin de fichier (absolu ou relatif au fichier de structure de 4D). Lorsque vous créer des liens vers des fichiers .4wp ou .4w7 (file://filepath ou filepath/file.4wp) : charge et remplace le document courant. Lorsque vous créez des liens vers d'autres types de fichiers, cela ouvre un fichier dans l'application par défaut du système pour le type de fichier.

bookmark

Texte

Nom du signet

Accède au signet mentionné dans le document courant. (Voir Gestion des signets)

method

Texte

Nom de la méthode projet - la méthode doit être existante et autorisée à l'aide de la commande SET ALLOWED METHODS.

Exécute la méthode 4D lorsqu'elle est cliquée. La méthode reçoit automatiquement deux paramètres dans $1 et $2:

Paramètre	Propriété	Type	Description
$1		Texte	Nom de la zone 4D Write Pro
$2		Objet
	method	Texte	Nom de la méthode 4D
	parameter	Texte \| Numérique	Paramètre utilisateur envoyé à la méthode via la propriété parameter (facultatif, voir ci-dessous)
	range	Objet	Plage de objCible

parameter

Texte | Numérique

Utilisé uniquement avec un lien de type method, non obligatoire si la méthode ne nécessite pas de paramétrage. Contient un paramètre supplémentaire à envoyer à la méthode.

Reçu en $2.parameter dans la méthode

Notes :

4D Write Pro n'accepte que des URL valides (codés). Les caractères spéciaux contenus dans les liens ne sont pas traduits. Si des caractères spéciaux sont nécessaires (par exemple %20 au lieu de " " pour les espaces) , vous devez les coder clairement. Si le lien n'est pas valide, une erreur est générée.
Les liens vers les méthodes 4D sont supprimés des documents 4D Write Pro lorsqu'ils sont exportés en format HTML, MIME HTML, ou .docx.
Si vous souhaitez supprimer un lien de objCible, veuillez consulter le paragraphe Gestion des liens.

Exemple 1

Vous souhaitez ajouter un lien dans votre site Web, au niveau du pied de page de votre document :

 C_OBJECT($footer)

 $footer:=WP Get footer(WPArea;1)

 WP SET TEXT($footer;"Veuillez consulter notre site Web";wk replace)

 WP SET LINK($footer;New object("url";"http://www.4d.com"))

Exemple 2

Vous souhaitez créer une table des matières contenant des liens à l'aide des signets de votre document :

 C_LONGINT($i;$n;$p;$memoStart)

 C_OBJECT($range;$link;$toc;$tocRange;$positionInfo;$target)

 C_TEXT($text)

 

 ARRAY TEXT($_bookmarks;0)

 WP GET BOOKMARKS(WParea1;$_bookmarks) //recenser tous les signets

 

 $n:=Size of array($_bookmarks)

 If($n>0)

    $tocRange:=WP Text range(WParea1;wk start text;wk start text) //trouver le début du texte

    WP INSERT BREAK($tocRange;wk page break;wk append;wk exclude from range) //ajouter un saut de page avant le texte

 

    For($i;1;$n) // Insérer la table des matières et les liens

       $range:=WP Bookmark range(WParea1;$_bookmarks{$i})

       $positionInfo:=WP Get position($range)

       $memoStart:=$tocRange.end

       WP SET TEXT($tocRange;Char(Tab)+$_bookmarks{$i}+Char(Tab)+String($positionInfo.page);wk append;wk include in range)

 

       $target:=WP Text range($tocRange;$memoStart+1;$memoStart+1+Length($_bookmarks{$i}))

       $link:=New object("bookmark";$_bookmarks{$i})

       WP SET LINK($target;$link)

       WP INSERT BREAK($tocRange;wk line break;wk append;wk include in range)

    End for

 End if

Exemple 3

Vous souhaitez fixer un lien dans une méthode 4D dans chaque chaîne "4D" d'un document :

 C_TEXT($text,$find)

 C_LONGINT($p)

 C_OBJECT($range;$link)

 

 $text:=WP Get text(wpArea;wk expressions as value) //récupérer tout le texte du document

 

 $find:="4D" //cible du lien

 

 $p:=Position($find;$text) //mettre une boucle dans le texte pour rechercher toutes les occurrences de la cible

 If($p>0)

    $range:=WP Text range(wpArea;$p;$p+LENGTH($find)) //fixer la longueur de la cible

  //créer l'objet lien

    $link:=New object("méthode";"myAlert";"paramètre";"Vive 4D!") //Ne pas oublier de donner l'autorisation à l'aide de la commande FIXER METHODES AUTORISEES  

 

    WP SET LINK($range;$link)

 End if

Voir aussi

Blog: Links in 4D Write Pro documents
WP Get links