SftTree/NET 2.0 - Tree Control for Windows Forms

AllowMergeFromUpperDefault Property, HeadersClass Class

Defines the default value for the CellBaseClass.AllowMergeFromUpper property for cells in column headers, whether cells are eligible to be used for cell merging by cells above.

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

Syntax

public bool AllowMergeFromUpperDefault { get; set; }

Public Property AllowMergeFromUpperDefault As Boolean

Value

True if cells are eligible to be used for cell merging by cells above, otherwise False.

The default value is False.

Comments

Defines the default value for the CellBaseClass.AllowMergeFromUpper property for cells in column headers, whether cells are eligible to be used for cell merging by cells above.

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

Examples

C#

            // 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;
                sftTree1.Headers[1, c].MergeWithNext = BoolOptionalEnum.True;
                sftTree1.Headers[1, c].Parts.Clear();

View Entire Sample Code

VB.NET

    ' 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
        sftTree1.Headers(1, c).MergeWithNext = BoolOptionalEnum.True
        sftTree1.Headers(1, c).Parts.Clear()

View Entire Sample Code

See Also HeadersClass Class | Classes | SftTree/NET 2.0