

| Type | Description | |||
| Item as Variant | A long expression that indicates the item's handle. | |||
| ColIndex as Variant | A long expression that indicates the column's index, a string expression that indicates the column's caption or the column's key. | |||
| Variant | A long expression that indicates the index of the cell that's merged with, a safe array that holds the indexes of the cells being merged. |

You can merge the first three cells in the root item using any of the following methods:
With Tree1
With .Items
.CellMerge(.RootItem(0), 0) = Array(1, 2)
End With
End WithWith Tree1
.BeginUpdate
With .Items
Dim r As Long
r = .RootItem(0)
.CellMerge(r, 0) = 1
.CellMerge(r, 0) = 2
End With
.EndUpdate
End WithWith Tree1
.BeginUpdate
With .Items
Dim r As Long
r = .RootItem(0)
.MergeCells .ItemCell(r, 0), .ItemCell(r, 1)
.MergeCells .ItemCell(r, 0), .ItemCell(r, 2)
End With
.EndUpdate
End WithWith Tree1
With .Items
Dim r As Long
r = .RootItem(0)
.MergeCells .ItemCell(r, 0), Array(.ItemCell(r, 1), .ItemCell(r, 2))
End With
End WithWith Tree1
With .Items
Dim r As Long
r = .RootItem(0)
.MergeCells Array(.ItemCell(r, 0), .ItemCell(r, 1), .ItemCell(r, 2))
End With
End WithThe following sample shows few methods to unmerge cells:
With Tree1
With .Items
.UnmergeCells .ItemCell(.RootItem(0), 0)
End With
End With
With Tree1
With .Items
Dim r As Long
r = .RootItem(0)
.UnmergeCells Array(.ItemCell(r, 0), .ItemCell(r, 1))
End With
End With
With Tree1
.BeginUpdate
With .Items
.CellMerge(.RootItem(0), 0) = -1
.CellMerge(.RootItem(0), 1) = -1
.CellMerge(.RootItem(0), 2) = -1
End With
.EndUpdate
End With
The following VB sample merges the first three cells in the focused item:
With Tree1.Items
.CellMerge(.FocusItem, 0) = 1
.CellMerge(.FocusItem, 0) = 2
End With
The following C++ sample merges the first three cells in the focused item:
#include "Items.h" CItems items = m_tree.GetItems(); COleVariant vtItem( items.GetFocusItem() ), vtColumn( long( 0 ) ); items.SetCellMerge( vtItem, vtColumn, COleVariant( long(1) ) ); items.SetCellMerge( vtItem, vtColumn, COleVariant( long(2) ) );
The following VB.NET sample merges the first three cells in the focused item:
With AxTree1.Items
.CellMerge(.FocusItem, 0) = 1
.CellMerge(.FocusItem, 0) = 2
End With
The following C# sample merges the first three cells in the focused item:
axTree1.Items.set_CellMerge(axTree1.Items.FocusItem, 0, 1); axTree1.Items.set_CellMerge(axTree1.Items.FocusItem, 0, 2);
The following VFP sample merges the first three cells in the focused item:
with thisform.Tree1.Items .DefaultItem = .FocusItem .CellMerge(0,0) = 1 .CellMerge(0,0) = 2 endwith
In other words, the sample shows how to display the first cell using the space occupied by three cells.