XtraReport.SnappingMode Property
Specifies the mode in which report elements are snapped to each other when they are resized or being relocated.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v19.1.dll
NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Core
Declaration
[DefaultValue(SnappingMode.SnapLines)]
[SRCategory(ReportStringId.CatDesign)]
public SnappingMode SnappingMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| SnappingMode | **SnapLines** | A SnappingMode enumeration value representing the snapping mode. |
Available values:
| Name | Description |
|---|---|
| None | No snapping is used. |
| SnapLines | Represents the snapping mode, which aligns a report element using snap lines. |
| SnapToGrid | Represents the snapping mode, which aligns a report element to the report snap grid. |
| SnapToGridAndSnapLines | Represents the snapping mode, which aligns a report element to both the snap grid and snap lines. |
Remarks
The SnappingMode property specifies the snapping mode used to align report elements to each other.
- None - no snapping is used.
- SnapLines - enables snapping to snap lines, which appear around the report control that is being moved or resized and indicates the distance to other report elements. Snap lines maintain the inner padding of report bands and outer margins of report controls specified by the Band.SnapLinePadding and XRControl.SnapLineMargin properties, respectively.
- SnapToGrid - enables snapping to the snap grid whose dimensions are defined by the XtraReport.SnapGridSize property. To specify whether to draw the grid over the report surface, use the XtraReport.DrawGrid property.
- SnapToGridAndSnapLines - enables snapping to both the snap grid and snap lines.
For more information, refer to Manipulating Report Controls.
Note
You can set the SnappingMode 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.