beginNewFrame

Topic group Related topics

Specifies whether rendering always starts in a new StreamFrame.

Property of

Band

Description

Set the beginNewFrame property of the StreamSource object’s detailBand to true if you want each row to be rendered in its own StreamFrame. If you have one StreamFrame in each PageTemplate, you will get one row per page. If you have multiple StreamFrames in each PageTemplate, each one will have at most one row of data.

You would create a page of labels by creating a StreamFrame for each label, set all the StreamFrame objects’ streamSource property to the same StreamSource, and set its detailBand’s beginNewFrame property to true.

Set the beginNewFrame property of a group’s headerBand to true if you want each group to start in a new StreamFrame. If you have one StreamFrame per page, that makes each group start on a new page.

If the beginNewFrame property of a group’s footerBand is true, then whenever it is rendered, it will start in a new StreamFrame. For example, you could print a summary page for a report by creating a large footerBand for the Report object’s reportGroup and set its beginNewFrame property to true.