WP DELETE SECTION

Home

4D v20 R7

WP DELETE SECTION


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

Parameter	Typ	Beschreibung
wpDoc	Objekt	4D Write Pro document
indexNumber	Ganzzahl	Index of the section to be deleted
count	Ganzzahl	Number of sections to be deleted


WP DELETE SECTION ( section )

Parameter	Typ	Beschreibung
section	Objekt	4D Write Pro section

Beschreibung

Der Befehl WP DELETE SECTION löscht das übergebene section-0bjekt oder löscht einen oder mehrere Abschnitte ab indexNumber und abhängig von der übergebenen count. Wenn ein Abschnitt entfernt wird, wird alles, was mit ihm verbunden ist, einschließlich des Kopfteils, des Fußteils, eines Teils des Hauptteils, der verankerten Bilder, der Textfelder und des abschließenden Umbruchs (unabhängig davon, ob es sich um einen Umbruch oder einen kontinuierlichen Umbruch handelt), ebenfalls entfernt.

Es wird ein Fehler ausgegeben, wenn der Befehl WP DELETE SECTION das Löschen aller Abschnitte verlangt oder wenn das Dokument nur einen Abschnitt enthält.

WP DELETE SECTION indiziert das Attribut anchorSection von Textrahmen und Bildern neu, um ihre Anker nach Änderungen an ihre Abschnitte anzupassen. Wenn ein Dokument beispielsweise vier Abschnitte hat und der zweite Abschnitt gelöscht wird, werden die Abschnitte 3 und 4 zu den Abschnitten 2 und 3. Textfelder und Bilder, die zuvor in den Abschnitten 3 und 4 verankert waren, werden nun in den Abschnitten 2 und 3 verankert.

Hinweis: Wenn ein Bild oder ein Textfeld auf einer Seite verankert ist (z.B. Seite 20) und diese Seite nach dem Löschen eines Abschnitts nicht mehr existiert, bleibt das Bild (oder das Textfeld) im Dokument erhalten und erscheint wieder auf Seite 20, wenn diese Seite später wieder existiert.

Beispiel

Den ersten Abschnitt des Dokuments zu entfernen:

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

  // nur Abschnitt 1 entfernen (ohne Fehler, außer es gibt nur einen Abschnitt im Dokument)

 WP DELETE SECTION(wpDoc;1)

Abschnitt 5 des Dokuments zu entfernen:

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

  // nur Abschnitt 5 entfernen

 WP DELETE SECTION(wpDoc;5)

Die Abschnitte 5, 6 und 7 des Dokuments zu entfernen:

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

 WP DELETE SECTION(wpDoc;5;3)

Zum Entfernen aller Abschnitte ab 5:

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

  // alle Abschnitte ab Abschnitt 5 entfernen (ohne Fehler, außer Abschnitt 5 existiert nicht)

 WP DELETE SECTION(wpDoc;5;MAXLONG)

Zum Abrufen und Entfernen von Abschnitt 5:

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

  // Abschnitt 5 aufrufen

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

  // $section entfernen

 WP DELETE SECTION($section)