Index

Data Source

Property Name	Description	Editable	Formula Control	Data Type
General
ClassType	Display the class type for the object: DataSource.	N	N	_
Others
QueryName	Display the query or UDS name.	N	N	_
QueryEditor	Click...on the right of the field to activate the query editor dialog. (Only for the query not for the UDS)	Y	N	_

Report Header Section

Property Name	Description	Editable	Formula Control	Data Type
General
ClassType	Display the Class Type: ReportHeaderPanel	N	N	_
Geometry
Width	The width of the section.	N	N	_
Height	The height of the section	Y	N	float
Color
Background	The background color. Use a string like "0xff00ff" to control or select in the palette.	Y	Y	String
Others
Style *	Apply predefined styles for fonts, colors, alignments and other properties to the selected object(s).	Y	N	String
Invisible *	If true, don’t display the section both in the view and the design mode.	Y	Y	Boolean
Suppressed *	If true, don’t display the section in the view mode.	Y	Y	Boolean
Label*	Display the section name in the design mode.	Y	N	String
OnNewPage	Start a new page to display this section if set true.	Y	Y (Before PageBreak)	Boolean
Underlay*	The section will go to next section’s (except pageheader and pagefooter) underground if set true	Y	Y (Before PageBreak)	Boolean
CanCrossPage	If the current page can’t hold the whole section contents, it will continue displaying the section and cross the page if set true or start new page if set false	Y	Y (Before PageBreak)	Boolean
SuppressBlankSection*	Don’t display the section if it is blank (no child) and set true.	Y	Y (Before PageBreak)	Boolean
FillWholePage*	The next section (except pageheader and pagefooter) will start from a new page if set true.	Y	Y (Before PageBreak)	Boolean

Many of the properties listed here are commonly used, and you will encounter them for other sections or objects. We will give you a detailed description of them.

Style

JReport Designer provides the style format painter, so that you can copy object and section formats. In other words, you can apply the formatting very easily to the objects without having to define again. The style includes fonts, colors, alignments.

To do so,

1. In the design mode, select the object of which you want to save the style. Right click your mouse, select Save Style item in the menu.
   
   
2. The Save Style dialog will pop up. Give the style name for your memo in the Label Style Name. Select the properties you want to save in the All properties panel and click the arrow to add into the Selected properties panel. You can also edit the selected properties here.
   
   
3. Click on the Save button, and next time when you want to use the style, you can do as follows:
   
   
4. The format of the selected object will be changed:
   
   

The above example is for an object, but for a section it is the same. You need to first select a section and save its style and then apply it to another section. But most often, we use this for an object.

Invisible

As the name suggests, it is to hide/show the section. The default value is false to show this section, but you set it to true, then this section will be hidden both in the design mode and view mode. You can in this case, go to Report Inspector and set it back to false to show it again. Compare it with Suppressed property.

Suppressed

The default value for the Suppressed property is false, so that you can view this section both in the view mode and design mode. But if true, this section will be hidden in the view mode. Note the difference from the Invisible property.

Design Mode

View mode:

For an object, whenever you set the property Suppressed or Invisible to be true, you will not view it or print it out. For Invisible to true, JREngine generates resultset, but for Suppressed to true, JREngine does not generate the resultset. For example: suppose you have a summarized field (Sub-total) inserted in group footer. If you set the detail section to be Invisible, when you view the report in JReport Designer, you will not see the detail section. Click the Sub-total field, you will see the drilldown of the detail section. But if you set the detail section to be Suppressed, you will see no drill down for the detail section.

Label

This will be the section name for your memo. The default will be ReportHeader, you can specify another name here.

Underlay

This property is used often for background picture or water mark. The default value is false, if set to true, this section will be the background for the next section.

Design Mode:

View Mode:

SuppressBlankSection

If no other objects are in this section, that is, this section is blank, then it will be suppressed. The default value for it is false.

FillWholePage

Lets this section extend to the bottom of this page, so that the contents in the section just below it will start from a new page.

Index