WP FIXER LIEN

4D v20 R7

WP FIXER LIEN


WP FIXER LIEN ( 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 FIXER LIEN 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 FIXER METHODES AUTORISEES.

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_OBJET($footer)

 $footer:=WP Lire pied(WPArea;1)

 WP FIXER TEXTE($footer;"Veuillez consulter notre site Web";wk replace)

 WP FIXER LIEN($footer;Creer objet("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_ENTIER LONG($i;$n;$p;$memoStart)

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

 C_TEXTE($text)

 

 TABLEAU TEXTE($_bookmarks;0)

 WP LIRE SIGNETS(WParea1;$_bookmarks) //recenser tous les signets

 

 $n:=Taille tableau($_bookmarks)

 Si($n>0)

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

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

 

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

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

       $positionInfo:=WP Lire position($range)

       $memoStart:=$tocRange.end

       WP FIXER TEXTE($tocRange;Caractere(Tab)+$_bookmarks{$i}+Caractere(Tab)+Chaine($positionInfo.page);wk append;wk include in range)

 

       $target:=WP Plage texte($tocRange;$memoStart+1;$memoStart+1+Longueur($_bookmarks{$i}))

       $link:=Creer objet("bookmark";$_bookmarks{$i})

       WP FIXER LIEN($target;$link)

       WP INSERER RUPTURE($tocRange;wk line break;wk append;wk include in range)

    Fin de boucle

 Fin de si

Exemple 3

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

 C_TEXTE($text,$find)

 C_ENTIER LONG($p)

 C_OBJET($range;$link)

 

 $text:=WP Lire texte(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

 Si($p>0)

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

  //créer l'objet lien

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

 

    WP FIXER LIEN($range;$link)

 Fin de si

Voir aussi

Blog: Links in 4D Write Pro documents
WP Lire liens