diff --git a/report-items/textbox.md b/report-items/textbox.md index d3c218e2a..386b41d35 100644 --- a/report-items/textbox.md +++ b/report-items/textbox.md @@ -23,18 +23,19 @@ The following image shows two TextBox report items. ![Two TextBox report items in the Report Designer](images/Textbox.png) -## Growing and Shrinking +## Growing, Shrinking, and Wrapping By default, the TextBox items have their size set. * To allow a TextBox to expand vertically based on its content, set the [`CanGrow`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanGrow) property to `True`, which is the default value. -* To allow a TextBox to shrink based on its content, set the [`CanShrink`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanShrink) property to `True`. By default, `CanShrink` is set to `False`. The TextBox will always grow to accommodate the first line of the text even when `CanGrow` is `False`. +* To allow a TextBox to shrink based on its content, set the [`CanShrink`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanShrink) property to `True`. By default, `CanShrink` is set to `False`. The TextBox will always grow to accommodate the first line of the text, even when `CanGrow` is `False`. +* Set [`TextWrap`](/api/telerik.reporting.textitembase#Telerik_Reporting_TextItemBase_TextWrap) property to `False` to ensure the content won't split and wrap to the next line when it cannot fit on a single line. In this case, the value of `CanGrow` doesn't influence the layout, as the content will be cut to fit within the available single-line area. When `CahShrink` is `True`, it will reduce the height of the TextBox to a single line. ## Text Orientation To change the text orientation in a TextBox item, use the [`Angle`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_Angle) property. This approach enables you to create more readable reports, supports locale-specific text orientation, fits more columns on a printed report that has a fixed page size, and creates reports with a better graphical appeal. -The layout of the tilted text starts from the corner of the client item rectangle and fits the text until finished. This behavior produces short initial text lines which can be avoided, if desired, by adding some empty lines at the beginning of the text or expression: +The layout of the tilted text starts from the corner of the client item rectangle and fits the text until finished. This behavior produces short initial text lines, which can be avoided, if desired, by adding some empty lines at the beginning of the text or expression: ````CSharp this.textBox1.Value = "= \"\r\n\r\n\" + Fields.MyDataColumn"; @@ -43,7 +44,7 @@ this.textBox1.Value = "= \"\r\n\r\n\" + Fields.MyDataColumn"; Me.textBox1.Value = "= """ & vbCr & vbLf & vbCr & vbLf & """ + Fields.MyDataColumn" ```` -The item grows vertically to accommodate a full tilted line from the left to the right edge which may produce a significant growth of the item especially for angles nearing 90 degrees. To avoid this behavior, set the [`CanGrow`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanGrow) property to `false`. +The item grows vertically to accommodate a full tilted line from the left to the right edge, which may produce a significant growth of the item, especially for angles nearing 90 degrees. To avoid this behavior, set the [`CanGrow`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanGrow) property to `false`. For angles in the 90-270 degree range, the item will grow until the whole text is fitted on a single line. To control this behavior, use the [`CanGrow`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanGrow) property. @@ -80,7 +81,7 @@ Before you apply a TextBox format, consider the following: * By default, numbers are formatted to reflect the cultural settings on the client computer. To specify how numbers are displayed and provide consistent formatting regardless of where the person who is viewing the report is located, use formatting strings. * The formats provided on the **Number** page are a subset of the .NET Framework standard numeric format strings. To format a number or a date by using a custom format that is not shown in the dialog box, use any number or date .NET Framework format strings. For more information about custom format strings, refer to the article [Formatting Types](https://learn.microsoft.com/en-us/dotnet/standard/base-types/formatting-types) topic. -* If you specify a custom format string, it will prevail over the default settings that are culture-specific. For example, if you set a custom format string of `#,###` to render 1234 as `1,234`, users in different parts of the world may interpret it in different ways. Before specifying a custom format, consider how the chosen format will affect users of different cultures viewing the report. +* If you specify a custom format string, it will prevail over the culture-specific default settings. For example, if you set a custom format string of `#,###` to render 1234 as `1,234`, users in different parts of the world may interpret it in different ways. Before specifying a custom format, consider how the chosen format will affect users of different cultures viewing the report. * If you specify an invalid format string, it will override the actual `Value`. For more information, refer to the article about the [**Format Builder** dialog]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/format-builder-dialog%}).