A script-enabled browser is required for this page to function properly.

Print Object On property

The Print Object On property specifies the frequency with which you want the object to appear in the report. The Print Object On property values indicate the logical page(s) on which the object should be triggered to print with regard to the Base Printing On object.

Note:  Just because the object is triggered to print on a logical page does not mean it will print on that logical page. Other settings (for example, Page Break Before) or the amount of space available on the page may cause Reports Builder to print an object on a page other than the one on which it was initially triggered to print.

In applying these options, Reports Builder considers the first page of an object to be the first logical page on which some part of the object is printed. Likewise, the last page is considered to be the last logical page on which some part of the object is printed. For example, if you set the Print Object On property to First Page and the object specified by the Base Printing On property to Enclosing Object, the object will be triggered to print on the first logical page on which its enclosing object appears.

Applies to

Layout objects

Values

All Pages
The object and all of its contents will be printed on all logical pages of the object specified by the Base Printing On property. The object will be repeated on any overflow pages of the Base Printing On object and will be truncated at the logical page boundary, if necessary.
All but First Page
The object and all of its contents will be printed on all logical pages of the object specified by the Base Printing On property, except the first logical page. The object will be formatted only on overflow pages of the Base Printing On object and will be truncated at the logical page boundary, if necessary.
All but Last Page
The object and all of its contents will be printed on all logical pages of the object specified by the Base Printing On property, except the last logical page. The object will be repeated on any overflow pages of the Base Printing On object except the last one and will be truncated at the logical page boundary, if necessary.
*Default
Reports Builder will use object positioning to set the Print Object On property to either *First Page or *Last Page for you. (The asterisk indicates that Reports Builder specified the setting for you.)
First Page
The object and all of its contents will only be printed on the first logical page of the object specified by the Base Printing On property. The object will be formatted and will overflow to subsequent pages, if necessary.
Last Page
The object and all of its contents will only be printed on the last logical page of the object specified by the Base Printing On property. The object will be formatted after the Base Printing On object and will overflow to subsequent pages, if necessary.

Default

Varies according to object.

Required/Optional

Required 

Restrictions

graphic depicting situation described above

Examples

Example 1:   Print Object On set to All Pages

Suppose that you have created a summary column named Col_Sum that sums the values of a column in a group named Group_1. Col_Sum is the source of a field (F_1) that is enclosed in a repeating frame (R_1), which contains the values from Group_1. If you specify a Print Object On of All Pages and a Base Printing On of Enclosing Object for F_1, it prints in every instance of R_1 on every logical page.

Example 2:   Overflow

The diagram below illustrates a layout and the resulting output.

graphic depicting situation described below

Because it is outside of repeating frame C, boilerplate object D's Base Printing On property setting refers to the repeating frame as a whole. Since they are inside the repeating frame, boilerplate objects A and B's Base Printing On property setting refer to each instance of repeating frame C.

Object D appears on all logical pages on which repeating frame C appears. Object A, however, only prints when an instance of repeating frame C overflows. The Print Object On property setting of All But First Page in this case means to trigger the object to print on every logical page of each instance of the repeating frame, except for the very first page on which an instance prints.

Since repeating frame C only contains two objects (boilerplate objects A and B), it only overflows to a second page when boilerplate object B overflows. Looking at the Print Object On property setting of objects A and B (All But First Page and First Page), you would think that these two objects could never appear on the same page. In this scenario, however, they can only appear on the same page.