WP DELETE SECTION

4D v20 R7

WP DELETE SECTION


WP DELETE SECTION ( wpDoc ; indexNumber {; count} )

Paramètre	Type	Description
wpDoc	Objet	Document 4D Write Pro
indexNumber	Entier	Index de la section à supprimer
count	Entier	Nombre de sections à supprimer


WP DELETE SECTION ( section )

Paramètre	Type	Description
section	Objet	Section 4D Write Pro

Description

La commande WP DELETE SECTION supprime l'objet section transmis, ou supprime une ou plusieurs sections à partir de l'indexNumber et en fonction du count transmis. Lorsqu'une section est supprimée, tout ce qui lui est associé, y compris l'en-tête, le pied de page, une partie du corps,les images et les zones de texte ancrées, et le saut de section final (qu'il s'agisse d'un saut de section ou d'un saut de section continu), est également supprimé.

Une erreur se produit si la commande WP DELETE SECTION demande de supprimer toutes les sections ou si le document ne contient qu'une seule section.

WP DELETE SECTION réindexe l'attribut anchorSection des zones de texte et des images afin d'ajuster leurs ancres à leurs sections après des modifications. Par exemple, si un document comporte quatre sections et que la deuxième section est supprimée, les sections 3 et 4 deviendront les sections 2 et 3 et les zones de texte et les images qui étaient auparavant ancrées aux sections 3 et 4 seront désormais ancrées aux sections 2 et 3.

Note : Si une image ou une zone de texte est ancrée à une page (par exemple, la page 20) et que cette page n'existe plus après la suppression d'une section, l'image (ou la zone de texte) restera dans le document et réapparaîtra à la page 20 si cette page existe à nouveau ultérieurement.

Exemple

On veut supprimer la première section du document :

 wpDoc:=WP Import document(“test.wp”)

  // supprimer uniquement la section 1 (sans erreur, sauf s'il n'y a qu'une seule section dans le document)

 WP DELETE SECTION(wpDoc;1)

On veut supprimer la section 5 du document :

 wpDoc:=WP Import document(“test.wp”)

  // supprimer uniquement la section 5

 WP DELETE SECTION(wpDoc;5)

On veut supprimer les sections 5, 6 et 7 du document :

 wpDoc:=WP Import document(“test.wp”)

 WP DELETE SECTION(wpDoc;5;3)

On veut supprimer toutes les sections à partir de la 5 :

 wpDoc:=WP Import document(“test.wp”)

  // supprimer toutes les sections à partir de la section 5 (sans erreur, sauf si la section 5 n'existe pas)

 WP DELETE SECTION(wpDoc;5;MAXLONG)

On veut récupérer et supprimer la section 5 :

 wpDoc:=WP Import document(“test.wp”)

  // récupèrer la section 5

 $section:=WP Get section(wpDoc, 5)

  // supprimer $section

 WP DELETE SECTION($section)