XtraReport.VerticalContentSplitting Property
Gets or sets a value indicating whether report controls outside the right page margin should be split across pages, or moved in their entirety to the next page.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v20.2.dll
NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core
Declaration
[DefaultValue(VerticalContentSplitting.Exact)]
[SRCategory(ReportStringId.CatBehavior)]
public VerticalContentSplitting VerticalContentSplitting { get; set; }
Property Value
Type | Default | Description |
---|---|---|
VerticalContentSplitting | Exact | A VerticalContentSplitting enumeration value, which specifies the splitting method of report controls in the vertical direction. |
Available values:
Name | Description |
---|---|
Exact | When the brick dimensions do not fit into the right page margin, the rest of the brick content is split across two pages. |
Smart | When the brick dimensions do not fit into the right page margin, the brick content is moved to a new page in its entirety. |
Remarks
Where some report controls are printed outside the right page margin, it may be required either to split these controls across two pages in place of a right margin line (for this set the VerticalContentSplitting property to VerticalContentSplitting.Exact), or to move them to the next page, so the appearance will be more professional (for this set the VerticalContentSplitting property to VerticalContentSplitting.Smart).
Because this property is exposed by the XtraReport class, you can’t choose a different behavior for splitting different controls. This algorithm is applied to rendering all report controls outside the right page margin.
If report controls are contained in an XRPanel control, or they are table cells belonging to an XRTable control, they are still split across pages in the vertical direction, irrespective of the setting of the VerticalContentSplitting property. In this scenario, the VerticalContentSplitting property is in effect only for parent controls splitting.