System.Classes.TStrings.Text

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Text: string read GetTextStr write SetTextStr;

C++

__property System::UnicodeString Text = {read=GetTextStr, write=SetTextStr};

Properties

Type Visibility Source Unit Parent
property public
System.Classes.pas
System.Classes.hpp
System.Classes TStrings

Description

Lists the strings in the TStrings object as a single string with the individual strings delimited by carriage returns and line feeds.

Use Text to get or set all the strings in the TStrings object in a single string delimited by carriage return, line feed pairs.

When reading Text, the strings in the list will be separated by carriage return and (on Windows) line feed. If any of the strings in the list contain a carriage return (and line feed), the resulting value of Text will appear to contain more strings than is indicated by the Count property.

When setting Text, the value will be parsed by separating into substrings whenever a carriage return or linefeed is encountered. (The two do not need to form pairs).

If the strings in the list contain carriage return or linefeed characters, a less ambiguous format for the strings is available through the CommaText or DelimitedText property.

See Also