Aller au contenu principal
Version: 20 R7 BETA

WP TABLE MERGE CELLS

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

ParamètreTypeDescription
targetObjObject→Range or element or 4D Write Pro document
tableRefObject→Table reference
startColumnInteger→Position of first cell column
startRowInteger→Position of first column row
columnCountInteger→Number of columns to merge
rowCountInteger→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