4D v16

WP Nouveau

Accueil

 
4D v16
WP Nouveau

WP Nouveau 


 

WP Nouveau {( 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 Nouveau 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 EXPORTER 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 Importer document.
  • un paramètre objet : dans ce cas, vous passez un objet plage 4D Write Pro. WP Nouveau 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 INSERER DOCUMENT, par exemple.

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

 myWPObject:=WP Nouveau

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

 C_TEXTE(myText)
 myText:="Nous sommes le "
 ST INSERER EXPRESSION(myText;"chaine(date du jour;Système date long)";ST Fin texte)
 myWPA:=WP Nouveau(myText)

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

  //Exporter un template depuis une zone existante
 C_TEXTE(wpTemplate)
 WP EXPORTER VARIABLE(myWPArea;wpTemplate;wk page web html 4D)
 
  // Utiliser le template pour une nouvelle zone
 C_OBJET(myNewWPA)
 myNewWPA:=WP Nouveau(wpTemplate)

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

 C_OBJET(wpArea)
 wpArea:=WP Nouveau([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.

 TABLEAU TEXTE($_BookmarkNames;0)
 WP LIRE SIGNETS([TEMPLATES]WP;$_BookmarkNames//lire les signets du template
 $targetRange:=WP Nouveau //créer un nouveau document vide (sera le document final)
 
 $p:=Chercher dans tableau($_BookmarkNames;"Main_Header") //traiter l'entête principal nommé "Main_Header"
 Si($p>0)
    $Range:=WP Lire plage signet(WParea;$_BookmarkNames{$p}) //sélectionner la plage
    $RangeDoc:=WP Nouveau($Range//créer un nouveau document depuis la plage
    WP INSERER DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) //wk append=après remplacement, $buildRange est égal à la fin du texte remplacé
 Fin de si



Voir aussi  

WP Importer document
WP INSERER DOCUMENT

 
PROPRIÉTÉS 

Produit : 4D
Thème : 4D Write Pro - Langage
Nom intl. : WP New

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)