WP Insert table

Home

4D v20 R7

WP Insert table


WP Insert table ( targetObj ; mode {; rangeUpdate {; nbCols {; nbRows}}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
mode	Lange Ganzzahl	Einfügemodus
rangeUpdate	Lange Ganzzahl	Modus Update Range
nbCols	Lange Ganzzahl	Anzahl Spalten für die Tabelle
nbRows	Lange Ganzzahl	Anzahl Zeilen für die Tabelle
Funktionsergebnis	Objekt	Objekt Tabelle

Beschreibung

Die Funktion WP Insert table fügt eine neue Tabelle in targetObj gemäß dem Einfügemodus in mode ein und gibt das entsprechende neue Objekt Tabelle zurück. Optional können Sie einen Parameter rangeUpdate sowie eine vordefinierte Anzahl Spalten in nbCols und Zeilen in nbRows angeben.

In targetObj übergeben Sie

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

Hinweis: Ist targetObj eine Tabelle, ersetzt die neu eingefügte Tabelle - je nach dem gewählten Einfügemodus - die alte, bzw. wird davor oder danach eingefügt. Eine Tabelle lässt sich nicht innerhalb einer anderen Tabelle einfügen.

Im Parameter mode übergeben Sie eine der folgenden Konstanten für den Einfügemodus:

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 eine der folgenden Konstanten übergeben, um festzulegen, ob die eingefügte Tabelle im Range enthalten ist:

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)

Übergeben Sie keinen Parameter rangeUpdate, ist die eingefügte Tabelle standardmäßig im Range enthalten.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

Über die optionalen Parameter nbCols und nbRows können Sie die Anzahl Spalten und Zeilen in der Tabelle definieren. Standardmäßig, d.h. ohne diese Parameter, wird eine neue Tabelle mit 0 Spalten und 0 Zeilen angelegt. Sie können diese Elemente dann mit der Funktion WP Table append row hinzufügen.

Die Funktion gibt die neue Tabelle als Tabellenobjekt zurück, das Sie dann in anderen Befehlen übergeben können, deren Name mit "WP Table" beginnt. Die Tabelle wird mit Standardschrift, -rahmen und Farbattributen erstellt. Mit dem Befehl WP SET ATTRIBUTES können Sie die Standardeinstellungen verändern.

Beispiel

In einem leeren Dokument eine neue Tabelle mit 3 Spalten und 2 Zeilen hinzufügen:

 C_OBJECT($WPRange;$WPTable)

 $WPRange:=WP Text range(WParea;wk start text;wk end text)

 $WPTable:=WP Insert table($WPRange;wk append;wk exclude from range;3;2)

Ergebnis:

Siehe auch

WP Table append row
WP Table get rows