WP INSERT PICTURE

4D v20

WP INSERT PICTURE


WP INSERT PICTURE ( objCible ; image ; mode {; miseAJourPlage} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
image	Image	Champ ou variable Image, ou chemin d'accès à une image sur le disque
mode	Entier long	Mode d'insertion
miseAJourPlage	Entier long	Mode de mise à jour de la plage de sélection

Description

La commande WP INSERT PICTURE insère image dans la plage de sélection objCible selon le mode d'insertion spécifié. L'image sera insérée en tant que caractère dans la plage de sélection objCible.

Dans objCible, passez :

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

Dans image, vous pouvez passer :

soit un champ image ou une variable image 4D,
soit une chaîne contenant un chemin d'accès à un fichier image stocké sur disque, en utilisant la syntaxe système.
Si vous utilisez une chaîne, vous pouvez passer soit un chemin d'accès complet, soit un chemin d'accès en relatif par rapport au fichier de structure de la base. Vous pouvez aussi passer un nom de fichier, dans ce cas le fichier doit être situé à côté du fichier de structure de la base. Si vous passez un nom de fichier, vous devez indiquer son extension.

Tous les formats d'image pris en charge par 4D peuvent être utilisés (voir la section Introduction aux images). Vous pouvez obtenir la liste des formats d'image disponibles en utilisant la commande PICTURE CODEC LIST. Si l'image encapsule plusieurs formats (codecs), 4D Write Pro utilise un seul format pour l'affichage et un autre pour l'impression (s'il est différent) ; les formats les mieux adaptés sont automatiquement sélectionnés.

Dans le paramètre mode, passez une des constantes suivantes pour indiquer le mode d'insertion à utiliser pour insérer l'image dans le document :

Constante	Type	Valeur	Comment
wk append	Entier long	2	Insère le contenu à la fin de la cible
wk prepend	Entier long	1	Le contenu est inséré au début de la cible
wk replace	Entier long	0	Remplace le contenu de la cible

Si objCible est une plage, vous pouvez utiliser le paramètre optionnel miseAJourPlage pour passer une des constantes suivantes et préciser si l'image est incluse ou non dans la plage de sélection résultante :

Constante	Type	Valeur	Comment
wk exclude from range	Entier long	1	Le contenu inséré n'est pas inclus dans la plage mise à jour
wk include in range	Entier long	0	Le contenu inséré est inclus dans la plage mise à jour (défaut)

Si vous ne passez pas le paramètre miseAJourPlage, par défaut l'image insérée est incluse dans la plage mise à jour.

Si objCible n'est pas une plage, miseAJourPlage est ignoré.

Exemple

Dans l'exemple suivant, un utilisateur choisit une image qu'il souhaite insérer dans une plage de sélection de l'objet 4D Write Pro, et obtiendra une alerte si l'image ne peut pas être insérée :

 C_OBJECT($wpRange)

 $wpRange:=WP Get selection([Courrier]ZoneWP)

 

 C_BOOLEAN($fail)

 $fail:=False

 

   //on demande à l'utilisateur de choisir, sur le disque,l'image qu'il souhaite insérer

 $imgRef:=Open document("")

   //si l'utilisateur n'annule pas

 If(OK=1)

         //si le format du fichier image est pris en charge

       If(Is picture file(document))

            // on insère l'image

          WP INSERT PICTURE($wpRange;document;wk replace)

       Else

          $fail:=True

       End if

 Else

       $fail:=True

 End if

   //si l'insertion a échoué, on informe l'utilisateur

 If($fail)

       ALERT("l'insertion de l'image a échoué")

 End if

Voir aussi

WP INSERT DOCUMENT
WP Picture range