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.v24.2.dll
NuGet Package: DevExpress.Reporting.Core
#Declaration
#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 not0
.
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.