WP TABLE MERGE CELLS

4D v20 R7


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

Paramètre	Type	Description
targetObj	Objet	Range or element or 4D Write Pro document
tableRef	Objet	Table reference
startColumn	Entier long	Position of first cell column
startRow	Entier long	Position of first column row
columnCount	Entier long	Number of columns to merge
rowCount	Entier long	Number of rows to merge

Description

La commande WP TABLE MERGE CELLSfusionne la sélection de cellules dans targetObj ou tableRef (défini par startColumn, startRow, columnCount, et rowCount).

Vous pouvez passer soit :

targetObj:
- une plage, ou
- un élément (ligne / corps / paragraphe / image ancrée / en-tête / pied / section / sous-section), ou
- un document 4D Write Pro

Si targetObj ne croise pas un tableau ou une plage de texte où une sélection de cellules peut être récupérée, la commande ne fait rien.

Si targetObj ne croise qu'une seule cellule, la commande WP TABLE MERGE CELLS ne fait rien.

tableRef - une référence de tableau.
startColumn et startRow - définissent les coordonnées gauche-haut de la première cellule à fusionner.
columnCount et rowCount (facultatif) - spécifie respectivement le nombre de colonnes et le nombre de lignes à fusionner.

Si rowCount est omis, cela équivaut à passer 1 (valeur par défaut). Si columnCount et rowCount sont tous deux omis, c'est l'équivalent de l'intersection d'une seule cellule, donc rien ne se passe.

Si startColumn plus ColumnCount ou startRow plus rowCount dépasse le nombre de colonnes/lignes dans tableRef, ou si startColumn ou startRow est supérieur au nombre de colonnes/lignes dans tableRef, la plage renvoyée contient le maximum de colonnes/lignes possibles, ce qui signifie que l'ensemble du tableau sera fusionné en une seule grande cellule.

Example

L'exemple suivant consiste à désigner une plage de cellules et à la fusionner :

 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)

Résultat :

Les données existantes des cellules d'origine sont concaténées dans la cellule fusionnée résultante.

Pour plus de détails, veuillez consulter Fusionner et fractionner des cellules.

Voir aussi

Manipuler des tableaux
WP TABLE SPLIT CELLS