Add to Favourites

Capabilities for Text Wrapping

Collection Attributes

Collection Attribute -Word Wrap

The Word Wrap attribute is introduced at the Collection (Table) level in TallyPrime Release 7.1 to control word wrapping of text in the first column of a table.

Syntax

[Collection: <Collection Name>]

Word Wrap: <Logical Expression>: <Compression Level>[: <Logical Value>]

Where,

<Collection Name> is the name of the collection where the word wrap is enabled.

<Logical Expression> is an expression to evaluate a logical value to specify whether the word wrap is enabled on the first column or not.

<Compression Level> specifies when the compression/wrapping should be triggered. This parameter is considered only when the first parameter is set to Yes. It accepts two values and the default value is Low.

• Low – Applies minimal compression to maintain better readability (20% compression).
• High – Applies higher compression while keeping the content readable (50% compression).

<Logical Value> specifies whether the Word Wrap attribute should override the global configuration “Auto Wrap Text”, and accepts logical values Yes or No.

This is an optional parameter. If it is not specified, the default value is No, and the attribute remains dependent on the F1 Help Configuration “Auto Wrap Text”.

Behaviour

• Works only on the first column of the table.
• Helps show long values in multiple lines instead of excessive compression.
• Requires the “Auto Wrap Text” option to be enabled in F1 Help Configuration (Settings → Display → Application), unless the third parameter is explicitly set to Yes.
• If disabled, values continue to display in a single compressed line.
• A single word will not be broken using a hyphen. Word breaks occur only at the following special characters.

Collection Attribute -Max Word Wrap Lines

The Max Word Wrap Lines is a new attribute in TallyPrime Release 7.1 that is introduced at collection (Table) level to define the maximum number of lines to which text in the first column of a table can automatically wrap.

Syntax

[Collection: <Collection Name>]

Max Word Wrap Lines: <Number of Lines>

Where,

<Collection Name> is the name of the collection in which the maximum word wrap line limit needs to be applied.

<Number of Lines> sets the maximum number of lines allowed. Default value will be set as 7.

• The maximum supported value is 50. If a value greater than 50 is specified, it will be treated as 50.

Behaviour

• Works only for the first column of the table.
• The “Auto Wrap Text” option under the F1 Help configuration must be enabled for this attribute to work (Navigation: F1 (Help) → Settings → Display → Application), unless the third parameter of the Word Wrap attribute is set to Yes.
• Does not work for table items behaving as Action, On The Fly, External Actions, or Labels.
• If multiple collections are used, the value is taken from the first table having a Title attribute.

Example for Word Wrap Attribute & Max Word Wrap Lines Attribute

[Collection: TSPL StockItem]

Title             : “List of Stock Item”
Use              :  List of Stock Items

Trigger             : TSPLStockItemName
Variable            : StockItemName
Report             : TSPL StockItemMaster

Word Wrap       : Yes : Low    
Max Word Wrap Lines : 3

In the above example, the Word Wrap attribute enables wrapping of long text in the first column of the Stock Item table. With the compression level set to Low, wrapping starts early for better readability. The Max Word Wrap Lines attribute limits the wrapped text to a maximum of 3 lines, keeping the table clean and easy to read.

Field Attributes

Field Attribute -Word Wrap

Word Wrap is a new attribute in TallyPrime Release 7.1 that is introduced at Field level to enable or disable automatic wrapping of text in String data type fields. It helps display long text in multiple lines for better readability instead of showing the text in a highly compressed single line.

When word wrap is enabled, Input Text Scroll is automatically applied to support smooth cursor movement and easy editing of long text within the field.

Syntax

[Field: <Field Name>]

Word Wrap : <Applicability Keyword> : <Compression Level>[: <Logical Value>]

Where,

<Field Name> is the name of the field in which word wrap needs to be applied.

<Applicability Keyword> specifies when word wrap should be enabled for the field.

• Supported values:
  • Always → Always enables word wrap for the field.
  • Never → Disables word wrap.
  • Repeated/Editable → Applies word wrap when the field is in a repeated line or when the field is editable (non-skip field).

<Compression Level> specifies when the compression/wrapping should be triggered. This parameter is considered only when the first parameter is set to Yes. It accepts two values and the default value is Low

• Low – Prioritizes better readability (~20% compression). Wrapping starts earlier.
• High – Allows more compression while maintaining readability (~50% compression). Wrapping starts later.

<Logical Value> specifies whether the Word Wrap attribute should override the global configuration “Auto Wrap Text”, and accepts logical values Yes or No.

This is an optional parameter. If it is not specified, the default value is No, and the attribute remains dependent on the F1 Help configuration “Auto Wrap Text”.

Behavior

• The “Auto Wrap Text” option under the F1 Help configuration must be enabled for this attribute to work (Navigation: F1 (Help) → Settings → Display → Application), unless the third parameter is explicitly set to Yes.
• Works only on simple display fields where text is directly shown.
• Not applicable to fields using the Lines attribute or FGHighlight attribute list.
• Not applied in Message Box / Query Box report fields, Print (Pixel Mode), Pre-print mode, or Tile reports in Dashboard.
• A single word will not be broken using a hyphen. Word breaks occur only at the following special characters.

Example

[Report: TSPL StockItemMaster]

Use : Stock Item

[Form : TSPL StockItemMaster]

Use : Stock Item

[#Field: MST Name]

Word Wrap : Repeated/Editable : Low

Max Word Wrap Lines Edit : 3

In the above example, the TSPL StockItemMaster report and form reuse the standard Stock Item definitions. The existing MST Name field is modified to enable Word Wrap with Repeated/Editable : Low, so long stock item names wrap when the field is used in repeated lines or edit mode, with early wrapping for better readability.

Field Attribute: Max Word Wrap Lines Edit

Max Word Wrap Lines Edit is a field-level attribute introduced in TallyPrime Release 7.1. to define the maximum number of lines to which text in a String field can wrap while the field is in edit mode. It helps control how much vertical space is used when entering or modifying long text.

Syntax

[Field: <Field Name>]

Max Word Wrap Lines Edit : <Number of Lines>

Where,

<Field Name> is the name of the field in which the edit mode line limit needs to be applied.

<Number of Lines> specifies the maximum wrapped lines allowed in edit mode. Default value will be set as 3.

• The maximum supported value is 50. If a value greater than 50 is specified, it will be treated as 50.

Behaviour

• The “Auto Wrap Text” option under the F1 Help configuration must be enabled for this attribute to work (Navigation: F1 (Help) → Settings → Display → Application), unless the configuration is overridden in the Word Wrap attribute.
• Applicable only to simple String fields where text is directly displayed.
• Not applicable to fields using the Lines attribute or FGHighlight attribute list.
• Used in voucher print reports to control wrapping and maintain the existing edit mode behavior.

Example

[Report:  TSPL StockItemMaster]

Use:  Stock Item

[Form :  TSPL StockItemMaster]

Use:  Stock Item

[#Field: MST Name]  

Word Wrap : Repeated/Editable : Low

Max Word Wrap Lines Edit : 3