WP Table insert rows

Home

4D v20 R7


WP Table insert rows ( targetObj \| {TabelleRef ; ZeilenNr} {; AnzZeilen} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range, Element oder 4D Write Pro Dokument
TabelleRef	Objekt	Referenz der Tabelle
ZeilenNr	Lange Ganzzahl	Zeilennummer
AnzZeilen	Lange Ganzzahl	Anzahl der Zeilen zum Einfügen (Standardwert = 1)
Funktionsergebnis	Objekt	Range of table rows

Beschreibung

Der Befehl WP Table insert rows fügt eine oder mehrere Zeilen in eine Tabelle targetObj in 4D Write Pro ein.

Dieser Befehl unterstützt zwei Syntaxarten:

Übergeben Sie targetObj als ersten Parameter, fügt der Befehl die Zeile(n) in der ersten Tabelle ein, die sich mit targetObj überschneidet. targetObj kann folgendes enthalten:
- Ein Range oder
- Ein Element (Zeile / Absatz / Haupt-, Kopf-, Fußteil / eingebundenes Bild / Absatz / Unterabsatz) oder
- Ein 4D Write Pro Dokument
  
  Überschneidet sich targetObj nicht mit einer Tabelle oder Text-Range, wo sich Zeilen einfügen lassen, führt der Befehl nichts aus und gibt Null zurück (Es wird kein Fehler erzeugt).

Übergeben Sie die Parameter TabelleRef und ZeilenNr, fügt der Befehl die Zeile(n) in der angegebenen Tabelle ab der angegebenen Zeilennummer ein. Ist ZeilenNr größer als die Anzahl Zeilen in der Tabelle TabelleRef, werden die Zeilen an die Tabelle angehängt.

Der optionale Parameter AnzZeilen definiert die Anzahl der Zeilen, die in targetObj oder TabelleRef eingefügt werden sollen. Ohne diesen Parameter wird standardmäßig eine Zeile eingefügt.

Ergebnis

Der Befehl gibt einen Zeilen-Range mit der/den eingefügten Zeile(n) zurück, oder Null, wenn nichts eingefügt wurde.

Beispiel

Zwei Zeilen am Ende der Tabelle Invoice einfügen:

 C_OBJECT($row)

 C_OBJECT($table;$row)

 C_LONGINT($rowNum)

 

 $table:=WP Get element by ID(WParea;"Invoice") //retrieve "Invoice" table

 

 If($table#Null)

    $rowNum:=$table.rowCount+1 //add 1 to last row to designate where to insert rows

    $row:=WP Table insert rows($table;$rowNum;2)

 End if

Das Ergebnis ist:

Siehe auch

WP Table insert columns