SftMask.TextPureWithLiterals Property	Softel vdm, Inc.

Returns the pure control contents, including literal characters.

Syntax       

	Get
		VB.NET	Text = object.TextPureWithLiterals  As String
		VB	Text = object.TextPureWithLiterals  As String
		C#.NET	string Text = object.TextPureWithLiterals;
		VC++	_bstr_t Text = object->TextPureWithLiterals; _bstr_t Text = object->GetTextPureWithLiterals();
		C	HRESULT object->get_TextPureWithLiterals(BSTR* Text);
		Delphi	Text := object.TextPureWithLiterals   : WideString;

object

A SftMask object.

Text

Returns the pure control contents, including literal characters.

Comments

The TextPureWithLiterals property returns the pure control contents, including literal characters.

When retrieving the property TextPureWithLiterals in a Masked Edit control (with Mask), input positions without data are represented by the carriage return (Chr(13)) character. This allows the distinction between unspecified data and specified (but blank) data fields. A simple edit control (without Mask) does not have unspecified positions and never uses the carriage return place holder.

Literal characters are always returned.

It is possible to retrieve portions of the control contents using the Contents.Value property.

The properties Text, TextDisplay, TextDisplayWithLiterals, TextDisplayNoLiterals and TextPureNoLiterals also retrieve the control contents with varying handling of unspecified input positions and literal characters.

Property	Unspecified Positions	Literals
Text	Chr(13)	ClipMode
TextDisplay	Space	ClipMode
TextDisplayNoLiterals	Space	No
TextDisplayWithLiterals	Space	Yes
TextPureNoLiterals	Chr(13)	No
TextPureWithLiterals	Chr(13)	Yes