officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-textbox-bb747054.md
Gets or sets the rule that determines the text box height.
Namespace : DevExpress.XtraRichEdit.API.Native
Assembly : DevExpress.RichEdit.v25.2.Core.dll
NuGet Package : DevExpress.RichEdit.Core
TextBoxSizeRule HeightRule { get; set; }
Property HeightRule As TextBoxSizeRule
| Type | Description |
|---|---|
| TextBoxSizeRule |
An enumeration member that specifies how to determine the text box height.
|
Available values:
| Name | Description |
|---|---|
| Auto |
Sets the height to fit entire text.
| | Exact |
Sets the height to an exact value specified by the Size property.
|
The default value of the HeightRule property is TextBoxSizeRule.Auto and the text box is stretched horizontally to fit its content if necessary. If you set the HeightRule property to TextBoxSizeRule.Exact, the text box retains its size as specified by the Size property.
Note
When a text box is resized by an end user, the HeightRule property is set to TextBoxSizeRule.Exact.
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.
winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/Shapes.cs#L78
// Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.ShapeFormat.TextBox.Document;
wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/ShapesActions.cs#L88
// Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.ShapeFormat.TextBox.Document;
word-document-api-examples/CS/CodeExamples/ShapesActions.cs#L143
// Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = TextBoxSizeRule.Auto;
SubDocument boxedDocument = myTextBox.ShapeFormat.TextBox.Document;
winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/Shapes.vb#L71
' Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = DevExpress.XtraRichEdit.API.Native.TextBoxSizeRule.Auto
Dim boxedDocument As DevExpress.XtraRichEdit.API.Native.SubDocument = myTextBox.ShapeFormat.TextBox.Document
wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/ShapesActions.vb#L78
' Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = TextBoxSizeRule.Auto
Dim boxedDocument As SubDocument = myTextBox.ShapeFormat.TextBox.Document
word-document-api-examples/VB/CodeExamples/ShapesActions.vb#L119
' Allow text box resize to fit contents.
myTextBox.ShapeFormat.TextBox.HeightRule = TextBoxSizeRule.Auto
Dim boxedDocument As SubDocument = myTextBox.ShapeFormat.TextBox.Document
See Also