WP Table get rows

Home

4D v19

WP Table get rows


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

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
TabelleRef	Objekt	Referenz auf Tabelle
StartZeile	Lange Ganzzahl	Position der ersten Zeile
AnzZeilen	Lange Ganzzahl	Anzahl der zu erhaltenden Zeilen
Funktionsergebnis	Objekt	Neuer Ausschnitt mit den gewählten Zeilen

Beschreibung

Die Funktion WP Table get rows gibt ein neues Objekt Zellen-Range mit der Zeilenauswahl von targetObj oder TabelleRef zurück, definiert durch StartZeile und AnzZeilen (optional).

Sie können folgendes übergeben:

targetObj:
- ein Range oder
- ein Element (Zeile / Absatz / Hauptteil / Kopfteil / Fußteil / eingebundenes Bild / Abschnitt / Unterabschnitt) oder
- ein 4D Write Pro Dokument

??Ist targetObj ein Tabellen- oder Text-Range, der keine Zeilenauswahl enthält, gibt der Befehl Null zurück.

zum Vergleich EN If targetObj does not intersect with a table or text range where a selection of cells can be retrieved, the command returns Null.

oder

TabelleRef - Referenz auf die Tabelle mit der betreffenden Zeilenauswahl
StartZeile - zeigt auf die erste zu erhaltende Tabellenzeile und
(optional) AnzZeilen - gibt an, wieviel Zeilen zurückgegeben werden sollen. Ohne den Parameter AnzZeilen wird nur die Zeile StartZeile zurückgegeben.

Übersteigt die Summe von StartZeile plus AnzZeilen die Anzahl Zeilen in TabelleRef, oder ist StartZeile größer als die Anzahl Zeilen in TabelleRef, enthält der zurückgegebene Range die max. möglichen Zeilen.

Beispiel 1

Für die beiden ersten Zeilen einer Tabelle eine Hintergrundfarbe setzen und den Rahmen der dritten Zeile ändern:

 C_OBJECT($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$rows;$rows2)

 $wpRange:=WP Create range(WParea;wk start text;wk end text)

 

 $wpTable:=WP Insert table($wpRange;wk append)

 $wpRow1:=WP Table append row($wpTable;"Paul";"Smith";25)

 $wpRow2:=WP Table append row($wpTable;"John";"Richmond";40)

 $wpRow3:=WP Table append row($wpTable;"Mary";"Trenton";18)

 $wpRow4:=WP Table append row($wpTable;"Christopher";"Lee";53)

 $wpRow5:=WP Table append row($wpTable;"Henry";"Cartier";42)

 

 $rows:=WP Table get rows($wpTable;1;2)

 WP SET ATTRIBUTES($rows;wk background color;0x00E0F0FF)

 $rows2:=WP Table get rows($wpTable;3)

 WP SET ATTRIBUTES($rows2;wk border style;wk solid)

 WP SET ATTRIBUTES($rows2;wk border width;4)

Beispiel 2

Einen Ausschnitt ab der 10. Zeile bis zum Ende erhalten:

WP Table get rows(tableRef;10;MAXLONG)

Beispiel 3

Die vom Benutzer ausgewählten Zeilen herausfinden:

 C_OBJECT($userSelection;$rows)

 

 $userSelection:=WP Selection range(myWPArea)

 

 $rows:=WP Table get rows($userSelection)

Siehe auch

WP Insert table
WP Table append row
WP Table get cells
WP Table get columns