SftTree/NET 2.0 - Tree Control for Windows Forms

MergeWithLower Property, CellBaseClass Class

Returns whether this cell is eligible to merge with the cell below.

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

Syntax

public BoolOptionalEnum MergeWithLower { get; set; }

Public Property MergeWithLower As BoolOptionalEnum

Value

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

The default value is BoolOptionalEnum.Default.

Comments

Returns whether this cell is eligible to merge with the cell below.

For cell merging to take effect, this cell must have its CellBaseClass.EvaluatedMergeWithLower property set to True. The merged cell (the cell below) must have its property CellBaseClass.EvaluatedAllowMergeFromUpper set to True to indicate that it is a candidate for cell merging. In addition, all cells involved in cell merging must either have the same cell text or all subordinate cells must be empty.

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

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

Examples

C#

            // In this sample, vertical merging is based on empty subordinate cells.
            sftTree1.MergeStyle = MergeStyleEnum.EmptyCells;

            // Merge all cells in the column header vertically (in the second column)
            // clear the text in all subordinate cells except for the first, main cell
            sftTree1.Headers.MaxLines = 4; // allow up to 4 text lines 
            for (int r = 0; r < sftTree1.Headers.Rows; ++r) {
                cell = sftTree1.Headers[r, 1];
                cell.MergeWithLower = BoolOptionalEnum.True;
                cell.AllowMergeFromUpper = BoolOptionalEnum.True;
                cell.Parts.Clear();
            }
            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));

View Entire Sample Code

VB.NET

    ' In this sample, vertical merging is based on empty subordinate cells.
    sftTree1.MergeStyle = MergeStyleEnum.EmptyCells

    ' Merge all cells in the column header vertically (in the second column)
    ' clear the text in all subordinate cells except for the first, main cell
    sftTree1.Headers.MaxLines = 4 ' allow up to 4 text lines 
    For r As Integer = 0 To sftTree1.Headers.Rows - 1
        cell = sftTree1.Headers(r, 1)
        cell.MergeWithLower = BoolOptionalEnum.True
        cell.AllowMergeFromUpper = BoolOptionalEnum.True
        cell.Parts.Clear()
    Next
    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))

View Entire Sample Code

See Also CellBaseClass Class | Classes | SftTree/NET 2.0