TreeList.ForceInitialize() Method

Forces the Tree List to finish its initialization.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.2.dll

Declaration

C#

public virtual void ForceInitialize()

VB.NET

Public Overridable Sub ForceInitialize

Remarks

You must call the ForceInitialize method before changing a TreeList’s options when a form is being loaded. After the Tree List has been initialized, you can manipulate its settings safely. For instance, you should call the ForceInitialize method before:

• applying data sorting;
• changing summary settings;
• expanding and collapsing nodes;
• creating columns and changing their visible state;
• restoring a layout, etc.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ForceInitialize() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-embed-treelist-control-to-a-report-at-runtime-e3239/CS/Reports/TreeReport.cs#L43

    treeList.ExpandAll();
    treeList.ForceInitialize();
}

how-to-change-a-treelist-node-position-along-with-a-corresponding-records-position-in-the-da-e3577/CS/Q351285/Form1.cs#L20

private void InitTreeList() {
    treeList1.ForceInitialize();
    UpdateNodesPositions(treeList1.Nodes);

how-to-provide-data-for-treelist-unbound-columns-using-event-t369036/CS/TreeList_UnboundDataViaEvent/Form1.cs#L41

// Resize columns proportionally.
treeList1.ForceInitialize();
treeList1.BestFitColumns();

how-to-set-individual-node-heights-by-creating-a-treelist-descendant-t419316/CS/CustomTreeList-NodeHeight/Form1.cs#L23

private void Form1_Load(object sender, EventArgs e) {
    treeList1.ForceInitialize();
    treeList1.ExpandAll();

how-to-make-the-treelist-control-look-like-a-treeview-e1153/CS/TreeView-example/Form1.cs#L18

private void Form1_Load(object sender, EventArgs e) {
    treeList1.ForceInitialize();

VB.NET

Reporting_how-to-embed-treelist-control-to-a-report-at-runtime-e3239/VB/Reports/TreeReport.vb#L45

    treeList.ExpandAll()
    treeList.ForceInitialize()
End If

how-to-change-a-treelist-node-position-along-with-a-corresponding-records-position-in-the-da-e3577/VB/Q351285/Form1.vb#L22

Private Sub InitTreeList()
    treeList1.ForceInitialize()
    UpdateNodesPositions(treeList1.Nodes)

how-to-provide-data-for-treelist-unbound-columns-using-event-t369036/VB/TreeList_UnboundDataViaEvent/Form1.vb#L43

' Resize columns proportionally.
treeList1.ForceInitialize()
treeList1.BestFitColumns()

how-to-set-individual-node-heights-by-creating-a-treelist-descendant-t419316/VB/CustomTreeList-NodeHeight/Form1.vb#L25

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    treeList1.ForceInitialize()
    treeList1.ExpandAll()

how-to-make-the-treelist-control-look-like-a-treeview-e1153/VB/TreeView-example/Form1.vb#L20

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    treeList1.ForceInitialize()