User Tools

Site Tools


withnext_set_widow_elimination_.htm
Navigation:  Language Reference > 9 -  Window and Report Attributes > Window and Report Attributes >====== WITHNEXT (set widow elimination) ====== Previous pageReturn to chapter overviewNext page

WITHNEXT( [siblings] )

blk2blue.jpg

WITHNEXT Specifies the structure is always printed on the same page as print structures PRINTed immediately following it.
siblings An integer constant or constant expression that specifies the number of following print structures to print on the same page. If omitted, the default value is one.

The WITHNEXT attribute (PROP:WITHNEXT) specifies that the DETAIL, or group HEADER or FOOTER structure (contained within a BREAK structure), is always printed on the same page as the specified number of print structures PRINTed immediately following it. This ensures that the structure is never printed on a page by itself, eliminating “widow” print structures. A “widow” print structure is defined as a group header, or first detail item in a related group of items, printed on the preceding page, separated from the rest of its related items.

The siblings parameter, if present, sets the number of following print structures that must be printed on the same page with the structure. To be counted, the following print structures must come from the same, or nested, BREAK structures. They must be related items. Any print structures not within the same, or nested, BREAK structures are printed but not counted as part of the required number of siblings.

Example:

CustRpt  REPORT

Break1    BREAK(SomeVariable)

          HEADER,WITHNEXT(2)    !Always print with 2 siblings

           !structure elements

          END

CustDetail DETAIL,WITHNEXT()     !Always print with 1 sibling

           !structure elements

          END

          FOOTER

           !structure elements

          END

         END

        END

withnext_set_widow_elimination_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)