Break Group Header Properties

Top  Previous  Next

This dialog lets you edit the properties of the group HEADER. To specify an element to compose at the start of each group, place it in the group HEADER.

Though they print on the page at the same time, the application composes the group HEADER before the group DETAIL. The group HEADER is a good place to identify the group, for example, with a label saying "Customer:" followed by a variable string for the customer name field.

 

Color

Enter a valid color equate in the TextColor or BackGround fields, or press the ellipsis (...) button to select a color from the Color dialog. The Window Designer adds the COLOR attribute to your header declaration.

See ..\LIBSRC\EQUATES.CLW for a list of valid color equates. See Windows Design Issues in the User's Guide for a discussion on using color to enhance your application.

 

Design

Freeze

"Freezes" all the controls on the band so that subsequent data dictionary changes are not applied. You can override the #Freeze attribute for all controls or for individual controls. See Application Options.

 

Extra

Absolute

Specifies that the HEADER section always prints at the same fixed position on the page. This adds the ABSOLUTE attribute to the DETAIL structure.

Alone

Specifies that the HEADER section always prints alone on a page.

Together

Specifies that the band is to only print on a single page, rather than being automatically split if there is not sufficient room for it. This adds the TOGETHER attribute.

 

General

Layout

Indicates the orientation of report controls.

Default maintains the current layout setting as defined by the main REPORT structure

Left to Right maintains the original layout specified in the Report Formatter.

Right to Left essentially "flips" the report controls’ display as a mirror image of the layout specified in the Report Formatter.

Page After

To print the HEADER, then force a new page, type a value in the Page after box. This sets the PAGEAFTER attribute. This prints the HEADER, then begins a new page.

The page number automatically increments, unless you reset it. To reset the page number to a value you specify, type it in the Page after field.

Page Before

To print the HEADER structure on a new page, type a value in the Page Before box in the Detail Properties dialog. This sets the PAGEBEFORE attribute. The print engine generates a page break before printing at the top of the next page.

The page number automatically increments, unless you reset it. To reset the page number to a value you specify, type it in the Page Before field.

TextFont

Calls the Font dialog which lets you select the font (typeface), size, style (such as bold or italic), color, and font effects (underline and strikeout) for all the controls in the report section. You may override the section font by setting a different font in the Properties dialog for any specific control. As you choose options, the dialog box displays a sample of the selected font.

Use

This defines the USE attribute for the structure. Type a field equate label to reference the HEADER in executable code.

With Next

To prevent 'widow' elements in a printout, type a value in the With Next field. This sets the WITHNEXT attribute. A 'widowed' print element is one which prints, but then is separated from the succeeding elements by a page break.

The value specifies the number of succeeding elements to print--a value of '1,' for examples, specifies that the next element must print on the same page, else page overflow puts them on the next.

With Prior

To prevent 'orphan' elements in a printout, type a value in the With Prior field. This sets the WITHPRIOR attribute. An 'orphaned' print element is one which prints on a following page, separated from its related items.

The value specifies the number of preceding elements to print--a value of "1," for example, specifies that the previous element must print on the same page.

 

Position

Lets you set the location and size of the group header. The position is relative to the top left corner of the paper.

The Position dialog lets you specify the AT attribute. Filling in the attribute manually is optional--you may set the position visually, by dragging with the mouse in the Report Designer's Page Layout View.

To set a location or size for your report section, specify fixed coordinates with this dialog. Choose from the following options for the Top Left Corner, the Width, and the Height.

Default

Sets a value based on the Paper Size and Print Detail position (see also Report Properties dialog).

Value

To set a specific position and size, mark the Fixed choices and enter a value in the entry box.

The measurement units for these boxes are specified on the General tab of the Report Properties dialog.

See Also:

How to Set Report Group Breaks

 

Quick Links

 

 

Embeds

Accesses the Embedded Source dialog for this procedure.