TextBox.HeightRule Property

Gets or sets the rule for determining the height of the text box.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v18.2.Core.dll

Declaration

C#

TextBoxSizeRule HeightRule { get; set; }

VB.NET

Property HeightRule As TextBoxSizeRule

Property Value

Type	Description
TextBoxSizeRule	A TextBoxSizeRule enumeration member specifying how the text box size is determined.

Available values:

Name	Description
Auto	Sets the height to fit entire text.
Exact	Sets the height to an exact value specified by the Shape.Size property.

Remarks

By default, the HeightRule is set to TextBoxSizeRule.Auto and the text box is stretched horizontally to fit its content if necessary. You can set the HeightRule property to TextBoxSizeRule.Exact so the text box retains its size as specified by the Shape.Size property.

Note

When the text box is resized by the end-user, the HeightRule is set to TextBoxSizeRule.Exact.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the HeightRule property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-add-a-watermark-with-a-text-or-image-to-the-document-e4184/CS/Form1.cs#L42

shape.Size = new SizeF(Units.PixelsToDocumentsF(sizeInPixels.Width, richEditControl.DpiX), Units.PixelsToDocumentsF(sizeInPixels.Height, richEditControl.DpiY));
shape.TextBox.HeightRule = TextBoxSizeRule.Auto;
shape.Offset = new PointF(section.Page.Width / 2 - shape.Size.Width / 2, section.Page.Height / 2 - shape.Size.Height / 2);

wpf-richedit-document-api-t213968/CS/DXRichEditControlAPISample/CodeExamples/ShapesActions.cs#L88

// Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.TextBox.Document;

winforms-richedit-document-api-e5219/CS/RichEditAPISample/CodeExamples/Shapes.cs#L77

// Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.TextBox.Document;

word-document-api-examples/CS/CodeExamples/ShapesActions.cs#L84

// Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.TextBox.Document;

VB.NET

how-to-add-a-watermark-with-a-text-or-image-to-the-document-e4184/VB/Form1.vb#L44

shape.Size = New SizeF(Units.PixelsToDocumentsF(sizeInPixels.Width, richEditControl.DpiX), Units.PixelsToDocumentsF(sizeInPixels.Height, richEditControl.DpiY))
shape.TextBox.HeightRule = TextBoxSizeRule.Auto
shape.Offset = New PointF(CLng(section.Page.Width) \ 2 - CLng(shape.Size.Width) \ 2, CLng(section.Page.Height) \ 2 - CLng(shape.Size.Height) \ 2)

wpf-richedit-document-api-t213968/VB/DXRichEditControlAPISample/CodeExamples/ShapesActions.vb#L78

' Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto
Dim boxedDocument As SubDocument = myTextBox.TextBox.Document

winforms-richedit-document-api-e5219/VB/RichEditAPISample/CodeExamples/Shapes.vb#L69

' Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto
Dim boxedDocument As SubDocument = myTextBox.TextBox.Document

word-document-api-examples/VB/CodeExamples/ShapesActions.vb#L76

' Allow text box resize to fit contents.
myTextBox.TextBox.HeightRule = TextBoxSizeRule.Auto
Dim boxedDocument As SubDocument = myTextBox.TextBox.Document