Skip to content

Update textbox.md #1670

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 28, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions report-items/textbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand All @@ -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.

Expand Down Expand Up @@ -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%}).
Expand Down