GridView.LayoutChanged() Method

Updates the View.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

C#

public override void LayoutChanged()

VB.NET

Public Overrides Sub LayoutChanged

Remarks

The LayoutChanged method recalculates all graphical information of the current View and redraws it. This method is called automatically when changes are applied to the View (for example, when changing row height, column width, etc). You may also call this method manually when the View needs to be updated. This can be used when you need the control to be updated in response to custom actions that don’t lead to automatic updating.

Calling the LayoutChanged method will have no effect in the following cases:

• the View is being initialized or destroyed;
• the BaseView.BeginUpdate method was called previously and there was no matching BaseView.EndUpdate method call;
• the method is called for a pattern view.

Calling the LayoutChanged method raises the BaseView.Layout event.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the LayoutChanged member must not be invoked for these Views. The LayoutChanged member can only be used with Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

• GridControl.MainView - returns the top most View in a grid;
• GridControl.FocusedView - returns the focused View;
• GridControl.DefaultView - returns the currently maximized View;
• the sender parameter of View specific events;
• GridView.GetDetailView - returns a detail clone View for a specific master row.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the LayoutChanged() 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-grid-async-load-data-in-unbound-column/CS/WindowsApplication3/Main.cs#L75

gridControl1.Invoke(new MethodInvoker(delegate{
    gridView1.LayoutChanged();
}));

winforms-grid-hide-group-footer-for-specific-level/CS/HideableGroupRowFooters/Form1.cs#L80

{
    myGridView1.LayoutChanged();
}

winforms-grid-highlight-modified-cells/CS/Form1.cs#L50

    modifiedCells.Clear();
    gridView1.LayoutChanged();
}

winforms-grid-rename-grid-filters-save-restore-layout/CS/WindowsApplication3/FilterNameProvider.cs#L92

        fItem.FilterName = filterNameEdit.Text;
    view.LayoutChanged();
}

winforms-grid-change-height-to-match-height-of-rows/CS/GridControlAutoSize/Form1.cs#L49

    gridControl1.Size = new Size(width, height);
    gridView1.LayoutChanged();
}

VB.NET

winforms-grid-async-load-data-in-unbound-column/VB/WindowsApplication3/Main.vb#L74

If gridControl1.InvokeRequired Then
    gridControl1.Invoke(New MethodInvoker(AddressOf gridView1.LayoutChanged))
Else

winforms-grid-hide-group-footer-for-specific-level/VB/HideableGroupRowFooters/Form1.vb#L73

Private Sub checkEdit1_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs) Handles checkEdit1.CheckedChanged
    myGridView1.LayoutChanged()
End Sub

winforms-grid-highlight-modified-cells/VB/Form1.vb#L53

    modifiedCells.Clear()
    gridView1.LayoutChanged()
End Sub

winforms-grid-rename-grid-filters-save-restore-layout/VB/WindowsApplication3/FilterNameProvider.vb#L110

    view.LayoutChanged()
End If

winforms-grid-change-height-to-match-height-of-rows/VB/GridControlAutoSize/Form1.vb#L56

    gridControl1.Size = New Size(width, height)
    gridView1.LayoutChanged()
End Sub