WP Table get columns

Home

4D v18


WP Table get columns ( targetObj ) \| ( TabelleRef ; StartSpalte {; AnzSpalten} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
TabelleRef	Objekt	Referenz auf Tabelle
StartSpalte	Lange Ganzzahl	Position der ersten Spalte
AnzSpalten	Lange Ganzzahl	Anzahl der zu erhaltenden Spalten
Funktionsergebnis	Objekt	Neuer Tabellenausschnitt mit den gewählten Spalten

Beschreibung

Die Funktion WP Table get columns gibt ein neues Objekt Zellen-Range mit der Auswahl der Spalten von targetObj oder TabelleRef zurück, definiert durch StartSpalte und AnzSpalten (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 Spaltenauswahl enthält, gibt der Befehl Null zurück.

oder

TabelleRef - Referenz auf die Tabelle mit der betreffenden Spaltenauswahl
StartSpalte - zeigt auf die erste zu erhaltende Tabellenspalte und
(optional) AnzSpalten - gibt an, wieviel Spalten zurückgegeben werden sollen. Ohne AnzSpalten wird die einzelne Spalte StartSpalte zurückgegeben.

Übersteigt StartSpalte plus AnzSpalten die Anzahl Spalten in TabelleRef, oder ist StartSpalte größer als die Anzahl Spalten in TabelleRef, enthält der zurückgegebene Range die maximal möglichen Spalten.

Beispiel 1

Die Attribute der letzten beiden Spalten einer Tabelle ändern:

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

 $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)

 

 $cols:=WP Table get columns($wpTable;2;2)

 WP SET ATTRIBUTES($cols;wk background color;0x00E0E0E0;wk text color;"red";wk height;"36pt";wk text align;wk center)

Ergebnis:

Beispiel 2

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

WP Table get columns(tableRef;10;MAXLONG)

Beispiel 3

Die vom Benutzer ausgewählten Spalten herausfinden:

 C_OBJECT($userSelection;$columns)

 

 $userSelection:=WP Selection range(myWPArea)

 

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

Siehe auch

WP Table get cells
WP Table get rows