WP INSERT BREAK

Home

4D v20 R7

WP INSERT BREAK


WP INSERT BREAK ( targetObj ; breakType ; mode {; rangeUpdate} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
breakType	Lange Ganzzahl	Typ des einzufügenden Umbruchs
mode	Lange Ganzzahl	Einfügemodus
rangeUpdate	Lange Ganzzahl	Update Modus für Range

Beschreibung

Der Befehl WP INSERT BREAK fügt einen neuen Umbruch vom Typ breakType im Bereich targetObj ein, gemäß den Parametern mode zum Einfügen und range Update.

In targetObj übergeben Sie:

Range
Element (Tabelle / Zeile / Absatz / Haupt- / Kopf- /Fußteil / Bild im Textfluß / Abschnitt / Unterabschnitt) oder
4D Write Pro Dokument.

In breakType können Sie eine der folgenden Konstanten unter dem Thema 4D Write Pro Konstanten übergeben:

Konstante	Typ	Wert	Kommentar
wk column break	Lange Ganzzahl	3	Spaltenumbruch: Fügt einen Spaltenumbruch ein
wk continuous section break	Lange Ganzzahl	5	Definiert einen kontinuierlichen Abschnittswechsel (wird oft verwendet, um die Anzahl der Spalten zu ändern, ohne eine neue Seite zu beginnen).
wk line break	Lange Ganzzahl	0	Zeilenumbruch (im gleichen Absatz)
wk page break	Lange Ganzzahl	2	Seitenumbruch: definiert eine neue Seite
wk paragraph break	Lange Ganzzahl	4	Absatzumbruch: definiert einen neuen Absatz
wk section break	Lange Ganzzahl	1	Abschnittsumbruch: definiert einen neuen Abschnitt

In mode übergeben Sie eine Konstante für den Einfügemodus des Umbruchs im Zielbereich targetObj:

Konstante	Typ	Wert	Kommentar
wk append	Lange Ganzzahl	2	Fügt Inhalt am Ende des Ziels ein
wk prepend	Lange Ganzzahl	1	Fügt Inhalt am Anfang des Elements ein
wk replace	Lange Ganzzahl	0	Ersetzt Inhalt in Ziel

Ist targetObj ein Range, können Sie im optionalen Parameter rangeUpdate über folgende Konstanten festlegen, ob der eingefügte Inhalt in den aktualisierten Range übernommen wird oder nicht:

Konstante	Typ	Wert	Kommentar
wk exclude from range	Lange Ganzzahl	1	Eingefügter Inhalt ist nicht im aktualisierten Range enthalten
wk include in range	Lange Ganzzahl	0	Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard)

Ohne den Parameter rangeUpdate wird der eingefügte Inhalt standardmäßig in den aktualisierten Range übernommen.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

Beispiel 1

Beim Einrichten von Rechnungen sollen Seitenumbrüche eingefügt werden, mit Ausnahme der letzten Seite:

 $nbInvoices:=Records in selection([INVOICE])

 For($j;1;$nbInvoices)

    ... //Rechnungen bearbeiten

    If($j#$nbInvoices) //Fügt Seitenumbruch ein mit Ausnahme der letzten Seite

       WP INSERT BREAK($buildRange;wk page break;wk append;wk exclude from range)

    End if

 End for

Beispiel 2

Sie möchten einen durchgehenden Abschnittswechsel einfügen, um einen einspaltigen Abschnitt und einen zweispaltigen Abschnitt auf derselben Seite zu haben.

1. Fügen Sie einen durchgehenden Abschnittswechsel an der Auswahl ein, um einen neuen Abschnitt zu erstellen:

 $range:=WP Selection range(*;"WParea")

 WP INSERT BREAK($range;wk kontinuierlicher Abschnittswechsel;wk append)

2. Setzen Sie die Spaltenanzahl für den ersten Abschnitt auf 2:

 $section:=WP Get section(WParea;1)

 WP SET ATTRIBUTES($section;wk column count;2)

Siehe auch

WP Get breaks
WP INSERT DOCUMENT