Skip to main content

TextEditBase.Text Property

Gets or sets the text entered in the editor.

Namespace: DevExpress.XamarinForms.Editors

Assembly: DevExpress.XamarinForms.Editors.dll

NuGet Package: DevExpress.XamarinForms.Editors

Declaration

public string Text { get; set; }

Property Value

Type Description
String

The text entered in the editor.

Remarks

Use the Text property to get or set text entered in the editor box.

Use the TextChangedCommand and TextChangedCommandParameter properties to specify the command executed when text changes. You can also handle the TextChanged event that fires when text changes.

After a user has finished the input and tapped the return button on the keyboard, the Completed event occurs.
To prevent users from entering text in the editor, set the IsReadOnly property to true.

Text Appearance

Use the following properties to customize the text appearance and alignment:

You can also use the CursorColor property to customize the color of the input cursor.

This example shows how to change the input text color and adjust font settings:

<dxe:TextEdit Text="Input text"
              TextColor="Blue"
              CursorColor="Blue"
              TextFontAttributes="Italic"
              TextFontSize="18"/>

Custom Fonts

To apply a custom font, add the font file to your solution, and then assign it to the editor’s TextFontFamily property.

This example shows how to apply the Verdana font.

  1. Add the font file to your platform-specific projects:

    • Android
      Add the font file to the Android project’s Assets folder and set Build Action: AndroidAsset.
    • iOS
      Add the font file to the iOS project’s Resources folder,
      set Build Action: BundleResource,
      and add the font file name to the Info.plist file (the UIAppFonts key in Visual Studio, or the Fonts provided by application property in Visual Studio for Mac).
  2. In the App.xaml file, add the following lines to the ResourceDictionary section:

    <OnPlatform x:TypeArguments="x:String" x:Key="Verdana">
      <On Platform="Android" Value="verdana.ttf#Verdana"/>
      <On Platform="iOS" Value="Verdana"/>
    </OnPlatform>
    
  3. Set the TextFontFamily property to the key defined for the custom font:

      <dxe:TextEdit TextFontFamily="{StaticResource Verdana}" />
    

Note

The TextFontAttributes property affects the default font only. If you need to apply a bold or an italic custom font, use the corresponding font style file as described above.

Input Validation

You can use the Text property to obtain the text entered in the editor and validate it.

This example shows how to validate the TextEdit‘s input text on a button tap. If no text is entered, the editor shows an error message.

  1. Specify the TextEdit instance’s name and a message that the editor should display when the error is detected.
    <dxe:TextEdit x:Name="loginEditor" 
                  ErrorText="Login cannot be empty!"/>
    
  2. Subscribe to the button’s Clicked event.

    <Button Text="Submit" Clicked="Button_Clicked"/>
    
  3. In the event handler, set the editor’s HasError property to true if the Text string is null or empty.

    private void Button_Clicked(object sender, EventArgs e)
    {
        loginEditor.HasError = string.IsNullOrEmpty(loginEditor.Text);
    }
    

Text Selection

Use the following properties to manage the cursor position and text selection:

Property

Description

CursorPosition

Gets or sets the cursor position.

SelectionStart

Gets a character index at which the selection starts.

SelectionLength

Gets the number of selected characters.

You can also use the SelectAll(), SetSelection(Int32), and SetSelection(Int32, Int32) methods to select text.

Clear Icon

An editor can display a ‘clear’ icon that allows users to remove text that was entered. Use the following properties to manage the ‘clear’ icon:

Property

Description

ClearIconVisibility

Specifies when the clear icon is displayed.

ClearIcon

Specifies the clear icon image.

ClearIconClicked
ClearIconCommand

Add a custom action to the ‘clear’ icon. Occurs when a user taps the clear icon.

ClearIconColor

Gets or sets the color of the clear icon.

Assistive Elements

You can also optionally specify Prefix and Suffix that are shown before and after the input text (TextEdit), and add the following assistive text elements that provide additional information about text entered in the editor:

  • LabelText - the editor’s label;
  • PlaceholderText - the placeholder displayed within the editor box prior to user text input;
  • HelpText - the help text displayed below the editor box;
  • ErrorText - the error message displayed below the editor box in an error state.

See Also