Version

Text Property

Gets or sets the value of the editor as text.
Syntax
'Declaration
 
Public Property Text As String
public string Text {get; set;}
Remarks

Setting the Text property will also update the Value property. If the new text can not be parsed into the value type (ValueType) then the Value property will not be updated. However note that the ValueChanged event will still be raised.

Note: As the user enters/modifies contents, the Text and Value properties will be synchronously updated to reflect the current contents. If the user input can not be parsed into the value type, the Text property will be updated however the Value property will retain last parsed value. However in such a case IsValueValid property will return False indicating that the user input is invalid.

Example
The following code demonstrates how Value, Text and DisplayText properties work. It demonstrates their behavior in regards to formatting and auto-conversion capabilities. The XAML code defines a XamTextEditor and a Button. The C#/VB code has the button's click event handler. Code in it sets the Value property property to a float number and prints out the values of Value, Text and DisplayText. Note that the ValueType is set to Decimal and that's why the Value property returns a Decimal even though it was set to a float.

Private Sub Button1_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.textEditor1.ValueType = GetType(Decimal)
    Me.textEditor1.Format = "C"
    Me.textEditor1.FormatProvider = New System.Globalization.CultureInfo("fr-FR")

    ' Even though we are setting the Value property to 10.5 as a float, the
    ' editor will automatically convert the value to type set on ValueType 
    ' property which we set to Decimal above.
    Me.textEditor1.Value = CType(10.5, System.Single)

    ' The Value property will automatically convert and return values of type
    ' set on the ValueType property, which we set above to Decimal.
    Debug.WriteLine("Value = " & Me.textEditor1.Value.ToString() & " as " & Me.textEditor1.Value.GetType().Name)

    ' Text property will return text representation of value without any formatting
    ' applied to it. This is what's going to be displayed when the editor enters
    ' edit mode.
    Debug.WriteLine("Text = " & Me.textEditor1.Text)

    ' DisplayText property will return text representation of value with formatting
    ' applied to it.
    Debug.WriteLine("DisplayText = " & Me.textEditor1.DisplayText)
End Sub
public void button1_Click( object sender, RoutedEventArgs e )
{
	this.textEditor1.ValueType = typeof( Decimal );
	this.textEditor1.Format = "C";
	this.textEditor1.FormatProvider = new System.Globalization.CultureInfo( "fr-FR" );

	// Even though we are setting the Value property to 10.5 as a float, the
	// editor will automatically convert the value to type set on ValueType 
	// property which we set to Decimal above.
	this.textEditor1.Value = (float)10.5;

	// The Value property will automatically convert and return values of type
	// set on the ValueType property, which we set above to Decimal.
	Debug.WriteLine( "Value = " + this.textEditor1.Value.ToString( ) + " as " + this.textEditor1.Value.GetType( ).Name );

	// Text property will return text representation of value without any formatting
	// applied to it. This is what's going to be displayed when the editor enters
	// edit mode.
	Debug.WriteLine( "Text = " + this.textEditor1.Text );

	// DisplayText property will return text representation of value with formatting
	// applied to it.
	Debug.WriteLine( "DisplayText = " + this.textEditor1.DisplayText );
}
<igEditors:XamTextEditor x:Name="textEditor1" />

<Button x:Name="button1"  Click="button1_Click">Click</Button>
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also