XtraReport.DrawGrid Property

Gets or sets a value indicating whether to draw the snap grid over the report surface.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

[DefaultValue(true)]
[SRCategory(ReportStringId.CatDesign)]
public bool DrawGrid { get; set; }

VB.NET

<DefaultValue(True)>
<SRCategory(ReportStringId.CatDesign)>
Public Property DrawGrid As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true, to display the snap grid; otherwise, false.

Remarks

By default, when a report is being edited, it is lined up by the snap grid. This helps to establish the distance between report elements and precisely align them to each other.

The DrawGrid property allows you to show or hide the snap grid as shown in the following image.

DrawGrid = true	DrawGrid = false

To specify whether to snap controls to the snap grid, use the XtraReport.SnappingMode property. To change the snap grid dimensions, use the XtraReport.SnapGridSize property.

Note

You can set the DrawGrid property globally, so that all the newly created reports have this property set to the required value. For this purpose, use the Report Designer Options dialog available within the XtraReports menu.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DrawGrid property.

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_winforms-end-user-designer-how-to-customize-the-popup-menu-e4343/CS/E4343/Form1.cs#L68

    MenuCommand command = sender as MenuCommand;
    command.Supported = command.Enabled = ActiveReport != null && !ActiveReport.DrawGrid;
}

VB.NET

Reporting_winforms-end-user-designer-how-to-customize-the-popup-menu-e4343/VB/E4343/Form1.vb#L78

Dim command As MenuCommand = TryCast(sender, MenuCommand)
command.Enabled = ActiveReport IsNot Nothing AndAlso Not ActiveReport.DrawGrid
command.Supported = command.Enabled