SftTree/NET 2.0 - Tree Control for Windows Forms

MergeWithNext Property, CellBaseClass Class

Returns whether this cell is eligible to merge with the next adjacent cell.

Class: CellBaseClass
Namespace: Softelvdm.Controls
Assembly: Softelvdm.SftTreeNET

Syntax

public BoolOptionalEnum MergeWithNext { get; set; }

Public Property MergeWithNext As BoolOptionalEnum

Value

True if this cell is eligible to merge with the next adjacent cell, otherwise False.

The default value is BoolOptionalEnum.Default.

Comments

Returns whether this cell is eligible to merge with the next adjacent cell.

For cell merging to take effect, this cell must have its CellBaseClass.EvaluatedMergeWithNext property set to True. The merged cell (the next adjacent cell) must have its property CellBaseClass.EvaluatedAllowMergeFromPrevious set to True to indicate that it is a candidate for cell merging. In addition, all subordinate cells must be empty.

HeadersClass.MergeWithNextDefault for column headers, FootersClass.MergeWithNextDefault for column footers and ColumnClass.MergeWithNextDefault for each column.

The CellBaseClass.EvaluatedMergeWithNext property can be used to define the status for this cell by evaluating the default settings.

Examples

C#

            TextPartClass tp = new TextPartClass("Vertical");
            tp.Format |= StringFormatFlags.DirectionVertical;
            sftTree1.Headers[0, 1].Parts.Add(tp);
            sftTree1.Headers[0, 1].Parts.Add(new ImagePartClass(img));
            tp = new TextPartClass("Cell merging in\na column header");
            sftTree1.Headers[0, 1].Parts.Add(tp);

            // Horizontally merge column header cells in row 1, columns 3 + 4
            sftTree1.Headers[1, 3].MergeWithNext = BoolOptionalEnum.True;
            sftTree1.Headers[1, 4].AllowMergeFromPrevious = BoolOptionalEnum.True;
            sftTree1.Headers[1, 3].Text = "Horizontally merged cells";
            sftTree1.Headers[1, 3].Image = img;
            sftTree1.Headers[1, 4].Parts.Clear();

            // Vertically merge some cells in the column footer (in the last column)
            sftTree1.Footers.MaxLines = 4; // allow up to 4 text lines 

View Entire Sample Code

VB.NET

    Dim tp As TextPartClass = New TextPartClass("Vertical")
    tp.Format = tp.Format Or StringFormatFlags.DirectionVertical
    sftTree1.Headers(0, 1).Parts.Add(tp)
    sftTree1.Headers(0, 1).Parts.Add(New ImagePartClass(img))
    tp = New TextPartClass("Cell merging in" & vbCrLf & "a column header")
    sftTree1.Headers(0, 1).Parts.Add(tp)

    ' Horizontally merge column header cells in row 1, columns 3 + 4
    sftTree1.Headers(1, 3).MergeWithNext = BoolOptionalEnum.True
    sftTree1.Headers(1, 4).AllowMergeFromPrevious = BoolOptionalEnum.True
    sftTree1.Headers(1, 3).Text = "Horizontally merged cells"
    sftTree1.Headers(1, 3).Image = img
    sftTree1.Headers(1, 4).Parts.Clear()

    ' Vertically merge some cells in the column footer (in the last column)
    sftTree1.Footers.MaxLines = 4 ' allow up to 4 text lines 

View Entire Sample Code

See Also CellBaseClass Class | Classes | SftTree/NET 2.0