Utilities.WrapText Method

Applies to TestComplete 15.10, last modified on December 01, 2021
This method is obsolete. See the Remarks section below.


The Utilities.WrapText method scans the given string (Line) for occurrences of any of the characters specified by the nBreakChars parameter and inserts a line break, specified by BreakStr, at the last occurrence of the character in nBreakChars before MaxCol (the maximum line length).


Utilities.WrapText(Line, BreakStr, nBreakChars, MaxCol)

Line [in]    Required    String    
BreakStr [in]    Required    String    
nBreakChars [in]    Required    Byte    
MaxCol [in]    Required    Integer    
Result String

Applies To

The method is applied to the following object:


The method has the following parameters:


Specifies the string to be split.


Specifies the symbol used as a line break. BreakStr typically includes the carriage return character.


Normally, nBreakChars is set to hold space, hyphen, tab and other similar characters on which to break the line.


Specifies the maximum length of the string. If the string’s length reaches the value of this parameter, this string is split into several lines.

Result Value

WrapText returns the string split into multiple lines.


This method is obsolete. It is supported for backward compatibility only. To process strings, use the methods of the aqString object.

See Also

Replace Method

Highlight search results