WP TABLE MERGE CELLS
WP TABLE MERGE CELLS ( targetObj ) | ( tableRef ; startColumn ; startRow {; columnCount{; rowCount}} )
| Paramètre | Type | Description | |
|---|---|---|---|
| targetObj | Object | → | Range or element or 4D Write Pro document |
| tableRef | Object | → | Table reference |
| startColumn | Integer | → | Position of first cell column |
| startRow | Integer | → | Position of first column row |
| columnCount | Integer | → | Number of columns to merge |
| rowCount | Integer | → | Number of rows to merge |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
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 (tableau / 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.
Ou
- 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