WP TABLE MERGE CELLS

Home

4D v20 R7


WP TABLE MERGE CELLS ( targetObj ) \| ( tableRef ; startColumn ; startRow {; columnCount{; rowCount}} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range or element or 4D Write Pro document
tableRef	Objekt	Table reference
startColumn	Lange Ganzzahl	Position of first cell column
startRow	Lange Ganzzahl	Position of first column row
columnCount	Lange Ganzzahl	Number of columns to merge
rowCount	Lange Ganzzahl	Number of rows to merge

Beschreibung

Der Befehl WP TABLE MERGE CELLS führt die Auswahl der Zellen im targetObj oder der tableRef (definiert durch startColumn, startRow, columnCount und rowCount) zusammen.

Pass entweder:

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

Wenn sich targetObj nicht mit einer Tabelle oder einem Textbereich überschneidet, in dem eine Auswahl von Zellen abgerufen werden kann, führt der Befehl nichts aus.

Wenn targetObj nur eine Zelle überschneidet, bewirkt der Befehl WP TABLE MERGE CELLS nichts.

tableRef - eine Tabellenreferenz.
startColumn und startRow - definieren die linken oberen Koordinaten der ersten Zelle, die zusammengeführt werden soll.
columnCount und rowCount (optional) - geben die Anzahl der Spalten bzw. die Anzahl der Zeilen an, die zusammengeführt werden sollen.

Wenn rowCount weggelassen wird, ist es gleichbedeutend mit der Übergabe von 1 (Standardwert). Wenn sowohl columnCount als auch rowCount weggelassen werden, entspricht dies dem Schneiden einer einzelnen Zelle, sodass nichts passiert.

Wenn startColumn plus ColumnCount oder startRow plus rowCount die Anzahl der Spalten/Zeilen in tableRef übersteigt, oder wenn startColumn oder startRow größer ist als die Anzahl der Spalten/Zeilen in tableRef, enthält der zurückgegebene Range die maximal möglichen Spalten/Zeilen, was bedeutet, dass die gesamte Tabelle in eine große Zelle zusammengeführt wird.

Beispiel

Sie möchten einen Range von Zellen bestimmen und diesen zusammenführen:

 WP TABLE MERGE CELLS($table;3;2;2;4)

  //or

 $cells:=WP Table get cells($table;3;2;2;4)

 WP TABLE MERGE CELLS($cells)

Ergebnis:

Vorhandene Daten aus den ursprünglichen Zellen werden in der resultierenden zusammengeführten Zelle verkettet.

Weitere Einzelheiten finden Sie unter Zellen zusammenführen und aufspalten.

Siehe auch

Handling tables
WP TABLE SPLIT CELLS