OnLayout

The OnLayout script is called when a band is positioned on a page. This event occurs after OnRenderEnd. At the point OnRenderEnd is called, the component has been rendered, but no page layout has been done. If the band won't fit on the current page, it may get pushed to the next one. In this case, any page footer will be rendered first. Next the page header of the next page will be rendered, finally the OnLayout will be triggered now the component has been placed on the page.

You should use OnLayout to process page-specific information - for example page totals. You can't use OnRenderEnd, because the appropriate page is not yet known and the totals may get added to the previous page instead.

-- JonPriddey - 04 Aug 2005