SubBand Class

A report band that provides a functional copy of the source band below which it is located.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

[BandKind(BandKind.SubBand)]
public class SubBand :
    Band,
    IXRSerializable,
    IEnumerable,
    IBrickOwner,
    IScriptable,
    IXtraSupportDeserializeCollectionItem,
    IXtraSerializable
<BandKind(BandKind.SubBand)>
Public Class SubBand
    Inherits Band
    Implements IXRSerializable,
               IEnumerable,
               IBrickOwner,
               IScriptable,
               IXtraSupportDeserializeCollectionItem,
               IXtraSerializable

To access the SubBandCollection belonging to a report Band, use its Band.SubBands property.

The following image illustrates the corresponding option in the context menu of an GUI.

report-sub-band-context-menu-end-user-designer

A band can have an unlimited number of sub-bands. Adding sub-bands is provided for all types of bands, except for the MarginBand and the SubBand itself.

After adding a sub-band to the collection, it provides a functional copy of the source band. A sub-band's behavior, as well as its position within the report band hierarchy, is dictated by the source band type.

report-sub-band-variety-end-user-designer

By using sub-bands, it is possible to create multiple versions of a band within a single report (e.g., to choose an appropriate version later on based on a specific condition).

See Introduction to Banded Reports for more details.

Inheritance

Implements

DevExpress.Utils.Serializing.Helpers.IXtraSupportDeserializeCollectionItem
DevExpress.Utils.Serializing.IXtraSerializable

See Also