Skip to main content
All docs
V23.2

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.