Detail Band

Description

The Detail band is the main band used to display recurrent data records from a data source. This band cannot be deleted from a report. Additional Detail bands cannot be added manually. By default, when a report is bound to a data source and the detail band contains data-bound controls, this band is printed as many times as there are records in the data source. When the Data Member property is not specified or is specified incorrectly, the Detail band will display the first data source record as many times are there are records in total.

Properties Common to Most Bands

For more information about the properties listed below, see Properties Common to Most Bands.

For more information regarding each of the property groups, see the Band Reference.

Actions

Sort Fields

Specifies the data field or fields that are used to order the content.

Keep Together with Detail Reports

Specifies whether the current Detail band will always be printed on the same page as the child Detail Report band. This property is only applicable if you have added a Detail Report band to your report.

Fill Empty Space

Sets whether to populate the empty space between the Detail band and the next band or end of the page. When this property is enabled, the empty region below the detail band is populated with copies of the band. The band retains its layout, but controls are printed without data.

If you wish to display static text in controls populated by data fields, set the Text property in the Properties panel to the value you wish to be repeated in the empty bands.

Multi-Column Options

This group of properties configures the Detail band to display multiple columns. The properties in this group include the following:

  • Column Count: Sets how many columns are present in each Detail band. When this property is set to a value greater than one, the Multi Column Options group becomes enabled.
  • Column Width: Sets the widths of the columns. When this property is set to a value greater than one, the Multi Column Options group becomes enabled.
  • Column Spacing: Sets the amount of space between columns.
  • Layout: Specifies the direction of the columns. Options include:
    • First Down then Across: Detail bands are printed in columns.
    • First Across then Down: Detail bands are printed in rows.
  • Mode: Specifies which multi-column properties will be taken into account when enabled. Options include:
    • None: Multi-column printing is disabled
    • Use Column Count: The width of the columns is calculated automatically based on number of columns specified in the Column Count property and the width of the page. The Column Width value is ignored.
    • Use Column Width: The number of columns is calculated automatically based on the value set in the Column Width property and the width of the page. The Column Count value is ignored.

Styles

Even Style

Type: String

Sets the style used when the report populates an even record from a bound dataset.

Setting an Even Style overrides configurations set in the Style property.

Odd Style

Type: String

Sets the style used when the report populates an odd record from a bound dataset.

Setting an Odd Style overrides configurations set in the Style property.

Behavior

Hierarchy Print Options

This group of properties is used to specify hierarchy print settings so that data printed in the Detail band is displayed in a tree mode.

Fill Empty Space

Sets whether to populate the empty space between the Detail band and the next band or end of the page. When this property is enabled, the empty region below the detail band is populated with copies of the band. The band retains its layout, but controls are printed without data.

If you wish to display static text in controls populated by data fields, set the Text property in the Properties panel to the value you wish to be repeated in the empty bands.

Keep Together with Detail Reports

Specifies whether the current Detail band will always be printed on the same page as the child Detail Report band. This property is only applicable if you have added a Detail Report band to your report.

Multi-Column Options

This group of properties configures the Detail band to display multiple columns. The properties in this group include the following:

  • Column Count: Sets how many columns are present in each Detail band.
  • Column Width: Sets the widths of the columns.

A value must be provided for either the Column Count or Column Width properties for multiple columns to appear in the band.

  • Column Spacing: Sets the amount of space between columns.
  • Layout: Specifies the direction of the columns. Options include:
    • First Down then Across: Detail bands are printed in columns.
    • First Across then Down: Detail bands are printed in rows.
  • Mode: Specifies which multi-column properties will be taken into account when enabled. Options include:
    • None: Multi-column printing is disabled
    • Use Column Count: The width of the columns is calculated automatically based on number of columns specified in the Column Count property and the width of the page. The Column Width value is ignored.
    • Use Column Width: The number of columns is calculated automatically based on the value set in the Column Width property and the width of the page. The Column Count value is ignored.

Data

Sort Fields

Specifies the data field or fields that are used to order the content.