XRLabel.CanGrow Property

Gets or sets a value indicating whether the label’s height can grow in order to display contents in their entirety.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v25.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[Browsable(true)]
public override bool CanGrow { get; set; }

VB.NET

<Browsable(True)>
Public Overrides Property CanGrow As Boolean

Property Value

Type	Description
Boolean	true if the label’s height can grow in order to display all its text; otherwise, false.

Remarks

When the CanGrow property is set to true, the label’s height will be automatically increased (if required), so that all the text it contains is displayed.

When using this feature, consider the following.

• If there are other controls below the current label, they are moved down to prevent them from overlapping.
• If a control overlaps the growing control by even one pixel, it will not be pushed down by the growing control.
• If a label’s XRControl.AnchorVertical property is set to VerticalAnchorStyles.Bottom or VerticalAnchorStyles.Both, the CanGrow and XRLabel.CanShrink property values are ignored and do not affect the final height calculation for this control.
• If a label calculates a summary, its CanGrow and XRLabel.CanShrink property values are ignored.
• The CanGrow property is ignored when the XRLabel.Angle property’s value is not 0.

Report controls are converted to bricks in the printed document layout, and we cannot change the brick’s size after document creation. If you have an editable control, it is not possible to automatically change the control’s size according to new text in the printed document layout. The editable area cannot exceed the control’s original dimensions.