Class ChildBand
This class represents a child band.
Inheritance
Inherited Members
Namespace: FastReport
Assembly: FastReport.Base.dll
Syntax
public class ChildBand : BandBase, IFRSerializable, IParentRemarks
Typical use of child band is to print several objects that can grow or shrink. It also can be done using the shift feature (via ShiftMode property), but in some cases it's not possible.
Properties
CompleteToNRows
Gets or sets a value that determines the overall number of data rows printed by the data band.
Declaration
public int CompleteToNRows { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
Remarks
Using this property, you may complete the data band upto N data rows. If the data band has less number of rows, this band will be used to print empty rows.
FillUnusedSpace
Gets or sets a value indicating that band will be used to fill unused space on a page.
Declaration
public bool FillUnusedSpace { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
If you set this property to true, the band will be printed several times to fill unused space on a report page.
PrintIfDatabandEmpty
Gets or sets a value indicating that the band will be printed if its parent databand is empty.
Declaration
public bool PrintIfDatabandEmpty { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
The child band with this property set to true, connected to a databand can be used to print "No data" text if the databand has no rows.
Methods
Assign(Base)
Copies the contents of another, similar object.
Declaration
public override void Assign(Base source)Parameters
| Type | Name | Description |
|---|---|---|
| Base | source | Source object to copy the contents from. |
Overrides
Remarks
Call Assign to copy the properties from another object of the same type. The standard form of a call to Assign is
destination.Assign(source);
which tells the destination object to copy the contents of the source object to itself. In this method, all child objects are ignored. If you want to copy child objects, use the AssignAll method.
See Also
Serialize(FRWriter)
Serializes the object.
Declaration
public override void Serialize(FRWriter writer)Parameters
| Type | Name | Description |
|---|---|---|
| FRWriter | writer | Writer object. |
Overrides
Remarks
Do not call this method directly. You should override it if you are developing a new component for FastReport.
This method is called when the object needs to save the state. It may happen when:
- saving the report to the file or stream;
- saving the report to the designer's undo buffer;
- assigning the object to another object using the Assign(Base) or AssignAll methods;
- saving the object to the designer's clipboard;
- saving the object to the preview (when run a report).