No Split Zone

No Split Zones are a defined section of a Report (they can only be used in the Detail section of a Report) where elements contained in a section are not split. The No Split Zone only affects a Report when the AutoSplit property on the Report’s Detail section is set to True. Essentially the No Split Zone allows a Report’s Detail section to be defined to automatically split when LayoutEngine determines it is able to split except for any areas defined by a No Split Zone. This provides a way to keep certain elements of the Report together (by putting them in your No Split Zone) while allowing others to be automatically split (by not including them in the No Split Zone and having the Detail’s AutoSplit set to True). A No Split Zone has no affect on a Report’s Detail section with more than one column.

The No Split Zone element has the following properties.

Properties

Properties Description
Id A value indicating the programmatic identifier of the No Split Zone.
Bottom A value indicating the Y coordinate for the bottom of the No Split Zone to end.
Top A value indicating the Y coordinate for the top of the No Split Zone to begin.

No Split Zone Association

Elements can fall into the No Split Zone under four conditions. Depending on the condition in which the element is part of the No Split Zone will determine the type of association that element will have with the rest of the elements in that No Split Zone.

Those associations are defined in the following table.

Name Description Behavior
Full Association The entire element falls within the No Split Zone. This element will not split at all.
Top Association The top of the element falls within the No Split Zone and the bottom of the element ends outside of the No Split Zone area. This element will always start with all the other elements in the No Split Zone. If a break can occur below the No Split Zone it will.
Bottom Association The element starts above the No Split Zone and the bottom of the element falls within the No Split Zone. This element will always end with all the other elements in the No Split Zone.  If a break can occur in the element above the No Split Zone it will.
No Association The element starts above the No Split Zone and ends below it. It essentially overlays the entire No Split Zone. This element is not considered part of the No Split Zone and therefore no special behavior is applied to it.

In this topic