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 |
|
||||||||||||
Default |
Varies according to object.
|
||||||||||||
Required/Optional |
Required
|
Caution: If its contents cannot fit within the logical page on which it starts to print, an object with its Print Object On property set to All Pages, All But First Page, or All But Last Page cannot overflow onto subsequent pages. In this case, the contents of the object will be truncated and the object will print with the same, truncated contents on every logical page it is triggered to print.
When an object is inside a repeating frame, and the report spreads across 2 or more pages, the Print Object On property setting may not work as described above.
If its contents cannot fit within the logical page on which it starts to print, an object with its Print Object On property set to First Page or Last Page can overflow onto subsequent pages. As a result, even though it is triggered to print only on the first or last page, it may overflow beyond the first or last page. As a result of overflow, a Print Object On property set to First Page and a Print Object On property set to All But First Page are not necessarily mutually exclusive. For example, if one object has its Print Object On property set to First Page and another is set to All But First Page, and they both have the same Base Printing On property setting, you might think that the two objects could never appear on the same page. However, if the object with First Page overflows onto the second page, the two objects could appear on the same page.
An object that is implicitly or explicitly anchored to its enclosing frame or repeating frame cannot have its Print Object On property set to Last Page or All But Last Page. An object that is anchored to another object within its frame or repeating frame cannot have its Print Object On property set to Last Page or All But Last Page with its Base Printing On property set to Enclosing Object.
If the Base Printing On property of an object is set to a repeating frame that encloses the object, then it refers to each instance of the repeating frame to which the object is anchored.
If the Base Printing On property of an object is set to a repeating frame and the object is outside of the repeating frame, then it refers to the repeating frame as a whole. For example, a Print Object On property setting of First Page means the first logical page on which the repeating frame is triggered to print.
Whether the Base Printing On property setting refers to a repeating frame as a whole or the instances of a repeating frame, the Print Object On property setting always refers to logical pages. For example, suppose the Base Printing On property of an object is set to a repeating frame and the object is outside of the repeating frame. In this case, the Base Printing On property setting would refer to the instances of the repeating frame. A Print Object On property setting of First Page, however, does not mean the first instance of the repeating frame. It means the first logical page on which each instance of the repeating frame is triggered to print.
Objects in the margin region are restarted on every physical page. As a result not all Print Object On property settings make sense for margin objects. Because objects are restarted on every page, it is as if you are always on the first page of the object. First Page is the same as All Pages. Last Page and All But Last Page are invalid because "last" is never reached. All But First Page causes the object to never appear because the object never goes beyond "first."
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.
The diagram below illustrates a layout and the resulting output.
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.
Copyright © 1984, 2005, Oracle. All rights reserved.