SftMask.TextPureNoLiterals Property	Softel vdm, Inc.

Returns the pure control contents, without literal characters.

Syntax       

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

object

A SftMask object.

Text

Returns the pure control contents, without literal characters.

Comments

The TextPureNoLiterals property returns the pure control contents, without literal characters.

When retrieving the property TextPureNoLiterals 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 never returned.

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

The properties Text, TextDisplay, TextDisplayWithLiterals, TextDisplayNoLiterals and TextPureWithLiterals 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