4D v17

WP New

Accueil

 
4D v17
WP New

WP New 


 

WP New {( source )} -> Résultat 
Paramètre Type   Description
source  Chaîne, BLOB, Objet in Chaîne : Source HTML 4D,
BLOB : Blob document 4D Write (.4w7/.4wt) ou document 4D Write Pro (.4wp),
Objet : Objet plage ou référence d'élément 4D Write Pro
Résultat  Objet in Objet 4D Write Pro

La commande WP New crée et retourne un nouvel objet 4D Write Pro.

Par défaut, si vous omettez le paramètre source, la commande retourne un objet 4D Write Pro vide.

Vous pouvez également utiliser le paramètre source, auquel cas le nouvel objet 4D Write Pro sera prérempli avec le contenu de source. Vous pouvez passer :

  • un paramètre chaîne : dans ce cas, vous passez une source de type HTML 4D, c'est-à-dire un texte exporté par WP EXPORT VARIABLE avec l'option wk web page html 4D. Ce texte peut contenir des références (balises et expressions 4D) et des images embarquées.
  • un paramètre blob : dans ce cas, vous passez soit :
    • un document au format 4D Write Pro (.4wp) stocké dans un BLOB. Pour plus d'informations sur le format de document 4D Write Pro, veuillez vous reporter au paragraphe Format de document .4wp.
    • une ancienne zone 4D Write chargée dans un BLOB (les Blobs contenant des documents .4w7 ou .4wt sont acceptés). Pour une liste détaillée des fonctions 4D Write qui sont actuellement prises en charge dans les objets 4D Write Pro, veuillez vous référer à la section Import de documents 4D Write.
      Si vous souhaitez importer un document 4D Write (.4w7 ou .4wt) stocké sur disque, utilisez plutôt la commande WP Import document.
  • un paramètre objet : dans ce cas, vous passez soit :
    • une plage ; dans ce cas, WP New retournera un nouveau document créé à partir de cette plage spécifique. A noter que si la plage n'est pas égale à la totalité du document, seule la première section est exportée et les signets, s'il y en a, ne sont pas exportés.
    • une référence d'élément (tableau / ligne / paragraphe / image en ligne / en-tête / pied de page) ; dans ce cas, WP New retournera un nouveau document dont le corps (body) sera constitué du contenu de l'élément (pour une ligne de tableau, le document contiendra un élément tableau constitué de la ligne).

L'objet retourné est un document complet pouvant être passé à la commande WP INSERT DOCUMENT, par exemple.

Vous voulez créer un objet 4D Write Pro vide :

 myWPObject:=WP New

Vous voulez créer un nouvel objet 4D Write Pro à l'aide d'un document 4D Write Pro stocké sur disque :

 C_BLOB($BlobDoc)
 C_OBJECT(myWPArea)
 DOCUMENT TO BLOB("myDoc.4wp";$BlobDoc//charger le document dans un Blob
 myWPArea:=WP New($BlobDoc)

Vous voulez créer un objet 4D Write Pro contenant une simple référence d'expression 4D :

 C_TEXT(myText)
 myText:="Nous sommes le "
 ST INSERT EXPRESSION(myText;"chaine(date du jour;Système date long)";ST End text)
 myWPA:=WP New(myText)

Vous voulez initialiser votre zone 4D Write pro avec un template précédemment créé :

  //Exporter un template depuis une zone existante
 C_TEXT(wpTemplate)
 WP EXPORT VARIABLE(myWPArea;wpTemplate;wk web page html 4D)
 
  // Use le template pour une nouvelle zone
 C_OBJECT(myNewWPA)
 myNewWPA:=WP New(wpTemplate)

Vous voulez importer dans une zone 4D Write Pro un document de l'ancien plug-in 4D Write stocké dans un champ de l'enregistrement courant :

 C_OBJECT(wpArea)
 wpArea:=WP New([Templates]Reference_)

Vous avez défini un document modèle (template) comportant différentes parties préformatées, chacune d'elles étant stockée en tant que signet. Lorsque vous produisez un document final à partir du template, vous pouvez traiter chaque signet en tant que nouveau document et l'insérer dans le document final.

 ARRAY TEXT($_BookmarkNames;0)
 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames//lire les signets du template
 $targetRange:=WP New //créer un nouveau document vide (sera le document final)
 
 $p:=Find in array($_BookmarkNames;"Main_Header") //traiter l'entête principal nommé "Main_Header"
 If($p>0)
    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) //sélectionner la plage
    $RangeDoc:=WP New($Range//créer un nouveau document depuis la plage
    WP INSERT DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) //wk append=après remplacement, $buildRange est égal à la fin du texte remplacé
 End if



Voir aussi  

WP Import document
WP INSERT DOCUMENT

 
PROPRIÉTÉS 

Produit : 4D
Thème : 4D Write Pro - Langage
Numéro : 1317

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D v14 R5
Modifié : 4D v15 R2
Modifié : 4D v16
Modifié : 4D v16 R5

 
UTILISATION DE L'ARTICLE

4D Write Pro ( 4D v17)