Difference between revisions of "TSmtpCli.CharSet"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
| + | [[Main_Page | Main page]] -> [[ICS_Components_Reference | ICS component reference]] -> [[TSmtpCli]] -> [[TSmtpCli.CharSet | CharSet ]] | ||
| + | |||
| + | == Definition == | ||
| + | |||
| + | '''property''' [[TSmtpCli]].CharSet : '''string'''; | ||
| + | |||
| + | == Description == | ||
| + | |||
Describes the content-type charset or charset of MIME inline encoded header lines. | Describes the content-type charset or charset of MIME inline encoded header lines. | ||
*In ICS-V5 and V6 it's just the string value used by the component to form header lines. | *In ICS-V5 and V6 it's just the string value used by the component to form header lines. | ||
*In ICS-V7 and later its value may also trigger charset conversion depending on whether property ConvertToCharset is set or not. | *In ICS-V7 and later its value may also trigger charset conversion depending on whether property ConvertToCharset is set or not. | ||
| − | * | + | * With ANSI compilers and ConvertToCharset set to TRUE the component converts MailMessage.Text and header lines from current, system ANSI codepage to the charset specified. |
| − | * | + | * With UNICODE compilers ConvertToCharset is always ignored and the UnicodeString is converted to the charset specified. |
Since ICS-V7 the component checks whether a charset is supported or not and raises an SmtpException on assignment of an unsupported charset! | Since ICS-V7 the component checks whether a charset is supported or not and raises an SmtpException on assignment of an unsupported charset! | ||
Assigning an empty string sets the default system charset silently. | Assigning an empty string sets the default system charset silently. | ||
| + | |||
| + | == Example == | ||
| + | SmtpCli1.CharSet := 'iso-8859-1'; | ||
| + | SmtpCli1.CharSet := 'utf-8'; | ||
| + | == See also == | ||
| + | *[[TIcsCharsetComboBox]] | ||
| + | *[[What's_new_in_TSmtpCli_V7 | What's new in TSmtpCli V7]] | ||
Revision as of 09:05, 29 May 2009
Main page -> ICS component reference -> TSmtpCli -> CharSet
Contents
Definition
property TSmtpCli.CharSet : string;
Description
Describes the content-type charset or charset of MIME inline encoded header lines.
- In ICS-V5 and V6 it's just the string value used by the component to form header lines.
- In ICS-V7 and later its value may also trigger charset conversion depending on whether property ConvertToCharset is set or not.
- With ANSI compilers and ConvertToCharset set to TRUE the component converts MailMessage.Text and header lines from current, system ANSI codepage to the charset specified.
- With UNICODE compilers ConvertToCharset is always ignored and the UnicodeString is converted to the charset specified.
Since ICS-V7 the component checks whether a charset is supported or not and raises an SmtpException on assignment of an unsupported charset! Assigning an empty string sets the default system charset silently.
Example
SmtpCli1.CharSet := 'iso-8859-1'; SmtpCli1.CharSet := 'utf-8';
