.. highlightlang:: us

.. _tablemergecells:

TableMergeCells
===============

.. index:: TableMergeCells

.. us.tag  TableMergeCells table.set New400 Changed530

:ref:`TableMergeCells` verbindet die gegebenen Zellen zu einer Zelle.

.. function::  bool = TableMergeCells(hTable, rvMerge)
    bool = TableMergeCells(hTable, rmMerge)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und
FALSE (0), wenn ein Fehler aufgetreten ist.
.. us.params

**Parameter**

.. uparam:: hTable

   *hTable* ist die Zugriffsnummer (Handle) des mit
   :ref:`TableCreate` erzeugten Tabellen-Objekts.

.. uparam:: rvMerge

   *rvMerge* ist ein Vektor mit vier Elementen, der einen Bereich
   der Tabelle auswählt, die zu einer Zelle verbunden werden sollen. 

   .. list-table::
      :header-rows: 1

      * - Element
        - Beschreibung
      * - rvMerge[1]
        - Linke Zelle
      * - rvMerge[2]
        - Obere Zelle
      * - rvMerge[3]
        - Rechte Zelle
      * - rvMerge[4]
        - Untere Zelle

   Die Spalten- und Zeilennummerierung beginnt mit 1. 

.. uparam:: rmMerge

   *rmMerge* ist eine Matrix mit 4 Spalten. Jede Zeile der Matrix legt einen 
   Zellbereich fest, der zu einer Zelle verbunden wird.

   .. list-table::
      :header-rows: 1

      * - Element
        - Beschreibung
      * - rmMerge[;1]
        - Linke Zelle
      * - rmMerge[;2]
        - Obere Zelle
      * - rmMerge[;3]
        - Rechte Zelle
      * - rmMerge[;4]
        - Untere Zelle

   Die Spalten- und Zeilennummerierung beginnt mit 1. 

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.3.0
     - Aufruf mit einer Matrix.

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetSelection`,
   :ref:`TableIsCellMerged`,
   :ref:`TableUnMergeCell`,
   :ref:`TableGetMergedCells`

:sub:`id-760935`