TreeList.ForceInitialize() Method

Forces the Tree List to finish its initialization.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v24.1.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList

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#

winforms-treelist-sync-position-of-nodes-with-data-records/CS/Q351285/Form1.cs#L20

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

winforms-treelist-unbound-columns/CS/TreeList_UnboundDataViaEvent/Form1.cs#L41

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

VB.NET

winforms-treelist-sync-position-of-nodes-with-data-records/VB/Q351285/Form1.vb#L26

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

winforms-treelist-unbound-columns/VB/TreeList_UnboundDataViaEvent/Form1.vb#L36

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