SftTree/NET 2.0 - Tree Control for Windows Forms

MergeWithLowerDefault Property, HeadersClass Class

Defines the default value for the CellBaseClass.MergeWithLower property for cells in column headers, whether cells are eligible to merge with cells below, in the same column.

Class: HeadersClass
Namespace: Softelvdm.SftTreeNET
Assembly: Softelvdm.SftTreeNET

Syntax

public bool MergeWithLowerDefault { get; set; }

Public Property MergeWithLowerDefault As Boolean

Value

True if cells are eligible to merge with the cell below, otherwise False.

The default value is False.

Comments

Defines the default value for the CellBaseClass.MergeWithLower property for cells in column headers, whether cells are eligible to merge with cells below, in the same column.

The default settings for cell merging can be defined using these properties: HeadersClass.MergeWithLowerDefault for column headers, FootersClass.MergeWithLowerDefault for column footers and ColumnClass.MergeWithLowerDefault for each column.

HeadersClass.MergeWithNextDefault and MergeWithLowerDefault should not be set to True at the same time to avoid intersecting merged cells (vertically and horizontally).

Examples

C#

            sftTree1.MergeStyle = MergeStyleEnum.SameText;

            // set merging default for each column
            foreach (ColumnClass col in sftTree1.Columns.Collection) {
                col.MergeWithLowerDefault = true;
                col.AllowMergeFromUpperDefault = true;
            }
            // set merging default for headers and footers
            sftTree1.Headers.MergeWithLowerDefault = true;
            sftTree1.Headers.AllowMergeFromUpperDefault = true;
            sftTree1.Footers.MergeWithLowerDefault = true;
            sftTree1.Footers.AllowMergeFromUpperDefault = true;

            // Horizontally merge column header cells in row 1, columns 1 through 4
            for (int c = 1 ; c <= 4 ; ++c) {
                sftTree1.Headers[1, c].AllowMergeFromPrevious = BoolOptionalEnum.True;

View Entire Sample Code

VB.NET

    sftTree1.MergeStyle = MergeStyleEnum.SameText

    ' set merging default for each column
    For Each col As ColumnClass In sftTree1.Columns.Collection
        col.MergeWithLowerDefault = True
        col.AllowMergeFromUpperDefault = True
    Next
    ' set merging default for headers and footers
    sftTree1.Headers.MergeWithLowerDefault = True
    sftTree1.Headers.AllowMergeFromUpperDefault = True
    sftTree1.Footers.MergeWithLowerDefault = True
    sftTree1.Footers.AllowMergeFromUpperDefault = True

    ' Horizontally merge column header cells in row 1, columns 1 through 4
    For c As Integer = 1 To 4
        sftTree1.Headers(1, c).AllowMergeFromPrevious = BoolOptionalEnum.True

View Entire Sample Code

See Also HeadersClass Class | Classes | SftTree/NET 2.0