4D v16

WP New

Accueil

 
4D v16
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 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 Importer des 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 un objet plage 4D Write Pro. 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. 

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 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)
 
  // Utiliser le template pour une nouvelle zone
 C_OBJECT(myNewWPA)
 myNewWPA:=WP New(wpTemplate)

Vous voulez importer dans une zone 4D Write Pro un document 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

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

 
HISTORIQUE 

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

 
UTILISATION DE L'ARTICLE

4D Write Pro ( 4D v16)