TreeList.InvalidateColumnPanel() Method

Invalidates the column header panel.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

C#

public virtual void InvalidateColumnPanel()

VB.NET

Public Overridable Sub InvalidateColumnPanel

Remarks

The InvalidateColumnPanel method repaints the column headers and column button of the TreeList control. This can be used if you want the mentioned elements to change their appearance at times when not repainted automatically. For instance, expanding nodes or scrolling through rows doesn’t invoke column panel repainting. Thus, you must force column header panel repainting manually if its appearance must be changed due to these actions.

Generally, the following must be done in order to use the InvalidateColumnPanel effectively.

• Write a TreeList.CustomDrawColumnHeader event handler. This enables you to paint column headers and the column button with respect to some custom conditions.
• Call the InvalidateColumnPanel method when the mentioned conditions have been changed (if these changes don’t force repainting automatically).

Use the TreeList.InvalidateColumnHeader method to control repainting of individual column headers.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the InvalidateColumnPanel() 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#

how-to-embed-a-checkbox-into-a-column-header-and-handle-clicks-on-it-e1327/CS/CheckBoxInColumnHeader/Form1.cs#L94

private void treeList1_SelectionChanged(object sender, EventArgs e) {
    treeList1.InvalidateColumnPanel();
}

VB.NET

how-to-embed-a-checkbox-into-a-column-header-and-handle-clicks-on-it-e1327/VB/CheckBoxInColumnHeader/Form1.vb#L100

Private Sub treeList1_SelectionChanged(ByVal sender As Object, ByVal e As EventArgs) Handles treeList1.SelectionChanged
    treeList1.InvalidateColumnPanel()
End Sub