Skip to main content
All docs
V25.1
  • Email Editor

    • 2 minutes to read

    The Email Editor (EmailBox) is a predesigned email input field with automatic email address validation and error indication.

    Email Address

    Use the editor’s Email or EditValue property to get an email typed by a user, or set it in code.

    string email = emailBox1.Email;
    object objEmail = emailBox1.EditValue;
    

    Handle the EditValueChanged event to respond to email changes.

    Field Labels & Prompt Text

    Use the HeaderLabel, FooterLabel, and Placeholder properties to specify the corresponding labels and placeholder.

    Email Editor Labels - WinForms UI Templates

    emailBox1.HeaderLabel = "Email";
    emailBox1.FooterLabel = "This must be your business email address.";
    emailBox1.Placeholder = "example@devexpress.com";
    

    Email Validation & Error Indication

    The Email Editor automatically validates the input value to ensure it is a properly formatted email address. If email validation fails, the editor displays a warning hint and the text-based feedback below the edit box if the editor displays the footer label.

    Email Editor Input Validation - WinForms UI Templates

    Warning Tooltip Customization

    Use the InvalidEmailWarningTitle property to specify a custom title of a warning hint.

    Turn off the ShowInvalidEmailWarningToolTip option to not display a warning hint.

    Show a Custom Leading Icon

    Use the LeadingIconOptions property to specify a custom icon or hide the default leading icon.

    HTML & CSS Template Customization

    The Email Editor is created with HTML & CSS templates. This allows you to create fully custom text input controls. Template customizations are handled with our HTML Template Editor that is integrated into the Visual Studio IDE. This tool uses an embedded Syntax Editor with autocomplete, tag navigation, and preview.