XRRichText.CanGrow Property
Gets or sets a value indicating whether the control’s height can grow in order to display the contents in their entirety.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v19.2.dll
NuGet Package: DevExpress.Reporting.Core
Declaration
Property Value
Type | Description |
---|---|
Boolean | true if the control’s height can grow in order to display all its text; otherwise, false. |
Remarks
When the CanGrow property is set to true, the control’s height will be automatically increased (if required) so that all the text it contains is displayed. If there are other controls below the current control, they will be moved down to prevent them from overlapping. Note that if a control overlaps the growing control by even one pixel, it will not be pushed down by the growing control.
Note
If the control’s XRControl.AnchorVertical property is set to VerticalAnchorStyles.Bottom or VerticalAnchorStyles.Both, the CanGrow and XRRichText.CanShrink property values are ignored, and don’t participate in calculating a final height value of this control.
Example
The following method demonstrates how to create an XRRichText object, set some of its properties, and then save its contents to a text file.
using System;
using DevExpress.XtraReports.UI;
// ...
public XRRichText CreateXRRichText(){
// Create an XRRichText object.
XRRichText xrRichText1 = new XRRichText();
// Set its height to be calculated automatically,
// and make its borders visible.
xrRichText1.CanGrow = true;
xrRichText1.CanShrink = true;
xrRichText1.Borders = DevExpress.XtraPrinting.BorderSide.All;
// Create an array of lines and assign it to the rich text.
string[] boxLines = new String[3];
boxLines[0] = "Line 1";
boxLines[1] = "Line 2";
boxLines[2] = "Line 3";
xrRichText1.Lines = boxLines;
// Export its contents to a text file.
xrRichText1.SaveFile("output.txt", XRRichTextStreamType.PlainText);
return xrRichText1;
}