BaseView.Invalidate() Method

Invalidates the region occupied by the current View (adds it to the control’s update region that will be repainted during the next paint operation), and causes a paint message to be sent to the grid control.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public virtual void Invalidate()

VB.NET

Public Overridable Sub Invalidate

Remarks

The Invalidate method does not force a synchronous paint. To force a synchronous paint, call the Update method of your grid control after calling Invalidate.

A View is automatically invalidated each time it is required. You may find that your application requires implementation of specific View behaviors such as custom painting particular grid elements. In such an instance, you may need to force invalidation manually. Generally, you will have to perform manual invalidation of particular View elements (not the entire view). Thus, BaseView class descendants provide methods that allow you to perform validation of their specific visual elements. Refer to the Manually Invalidating Controls help topic for details on when you may need to invoke invalidation manually and how this can be accomplished.

Note

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

• 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 Invalidate() 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-replace-the-cursor-with-a-thumbnail-image-while-dragging-a-row-in-gridview-e2735/CS/DragDrop/DragHelper.cs#L94

    dropTargetRowHandle = value;
    _View.Invalidate();
}

how-to-show-the-editors-button-when-the-mouse-is-hovering-over-the-grids-cells-e1956/CS/WindowsApplication3/Form1.cs#L35

        rowHandle = -1;
   view.Invalidate();
}

how-to-draw-a-rectangle-around-selected-cells-and-implement-a-copy-paste-functionality-e1603/CS/Q212929/CellSelectionHelper.cs#L186

    selectedArea.X = int.MaxValue;
    fView.Invalidate();
}

how-to-drag-multiple-columns-in-a-grid-at-once-e3385/CS/WindowsApplication3/MultiColumnsDragProvider.cs#L108

        dragRectangle = Rectangle.Empty;
    view.Invalidate();
}

VB.NET

how-to-customize-columns-order-and-visibility-in-a-custom-drop-down-menu-e2015/VB/Sample/CustomGridControl.vb#L266

    vi.QuickCustomisationIconStatus = QuickCustomisationIconStatus.Hot
    ViewInfo.View.Invalidate()
End If

how-to-replace-the-cursor-with-a-thumbnail-image-while-dragging-a-row-in-gridview-e2735/VB/DragDrop/DragHelper.vb#L88

    dropTargetRowHandle_Renamed = value
    _View.Invalidate()
End Set

how-to-show-the-editors-button-when-the-mouse-is-hovering-over-the-grids-cells-e1956/VB/WindowsApplication3/Form1.vb#L38

    End If
   view.Invalidate()
End Sub

how-to-draw-a-rectangle-around-selected-cells-and-implement-a-copy-paste-functionality-e1603/VB/Q212929/CellSelectionHelper.vb#L218

    selectedArea.X = Integer.MaxValue
    fView.Invalidate()
End Sub

how-to-drag-multiple-columns-in-a-grid-at-once-e3385/VB/WindowsApplication3/MultiColumnsDragProvider.vb#L97

    End If
    view.Invalidate()
End Sub