MaskEdit Object (ExMaskEdit)

The eXMaskEdit helps ensure consistent and accurate data entry by allowing you to define input rules for specific fields. When multiple users enter data into your application or database, you can use masks to control how that data is entered, such as requiring phone numbers to follow a specific national format or restricting addresses to a certain pattern. You can define precise input masks to guide users during data entry, and also choose how the same data is displayed afterwards using a different format. This not only improves data consistency but also simplifies validation and display, making your application more reliable and easier to manage.

Features include:

1. Masking Functionality

Ability to define and use one or more masks at runtime
Insert or Overtype mode support
Restrict Input Data until the user enters the appropriate value
Ability to define valid characters using the [] directive
Ability to specify margins of numbers using the {} directive

2. Feedback and Validation

HTML ToolTip support
Warning and Beep support (alerts user on invalid input)
Ability to highlight entities with a different color while the entire mask is not completed

3. Alignment and Appearance

Left alignment support
Right alignment support
Center alignment support
Ability to highlight parts of the mask visually

4. Supported Mask Types

Floating/decimal point numbers (including digit grouping)
License keys
IP addresses
URLs
E-mails
Phone numbers
Extensions, ZIP codes
Social security numbers
Decimal numbers
Hexadecimal numbers
Binary numbers
Alphabetic and digit characters
RGB and ARGB color values
Date and time
Passwords
and more...

The object supports the following properties and methods:

		Name	Description
		ActiveMask	Specifies the index of active mask.
		Alignment	Aligns the control's text.
		AllowBeep	Specifies whether the control plays a beep once the user enters any invalid character.
		AllowContextMenu	Specifies whether the control displays the content menu when user right clicks the control.
		AllowEmptyValue	Specifies whether the field supports empty values.
		AllowToggleInsertMode	Specifies whether the control is toggling the InsertMode when the user presses the Insert key.
		Appearance	Retrieves or sets the control's appearance.
		AttachTemplate	Attaches a script to the current object, including the events, from a string, file, a safe array of bytes.
		BackColor	Specifies the control's background color.
		BackColorReadOnly	Indicates the control's background when the control is read only.
		Background	Returns or sets a value that indicates the background color for parts in the control.
		CursorPos	Retrieves or sets a value that indicates the cursor position.
		Enabled	Enables or disables the control.
		EventParam	Retrieves or sets a value that indicates the current's event parameter.
		ExecuteTemplate	Executes a template and returns the result.
		Font	Retrieves or sets the control's font.
		ForeColor	Specifies the control's foreground color.
		ForeColorReadOnly	Indicates the control's foreground when the control is read only.
		ForeColorRich	Retrieves or sets the color to show the editable entitity, while the Type is RichEdit and the value is not completed.
		HTMLPicture	Adds or replaces a picture in HTML captions.
		hWnd	Retrieves the control's window handle.
		Images	Sets at runtime the control's image list. The Handle should be a handle to an Images List Control.
		ImageSize	Retrieves or sets the size of icons the control displays.
		InsertMode	Specifies the control's inserting mode that could be insert-type or over-type.
		Invalid	Indicates the html-tooltip message to be shown when the user enters an invalid value.
		Mask	Retrieves or sets a string expression that indicates the control's mask.
		MaskChar	Retrieves or sets a value that determines masking character.
		MaskFloat	Specifies whether the Mask property masks a floating point number.
		Masks	Retrieves or sets a value that determines all possible masks that user can use at runtime.
		MultiLine	Retrieves or sets a value that determines whether the control can accept multiple lines of text.
		Password	Displays all characters as an asterisk (*)
		PasswordChar	Retrieves or sets a value that determines password character.
		ReadOnly	Retrieves or sets a value that determines whether the control is read only.
		Refresh	Refreshes the control's field.
		ReplaceIcon	Adds a new icon, replaces an icon or clears the control's image list.
		Right	Right aligns text in a single-line or multiline edit control.
		Select	Selects the text between Start and End
		SelectGotFocus	Indicates whether the entire text is selected once the field receives the focus.
		SelEnd	Returns or sets the ending point of text selected.
		SelStart	Returns or sets the starting point of text selected.
		ShowImageList	Specifies whether the control's image list window is visible or hidden.
		ShowToolTip	Shows the specified tooltip at given position.
		Template	Specifies the control's template.
		TemplateDef	Defines inside variables for the next Template/ExecuteTemplate call.
		TemplatePut	Defines inside variables for the next Template/ExecuteTemplate call.
		Text	Retrieves or sets the text displayed in the control.
		TextIncludeLiterals	Determines the way the Text property returns or set the value of the field
		TextIncludeLiteralsLoseFocus	Determines how the field shows its content once it loses the focus.
		Type	Retrieves or sets the base class for the mask field.
		Valid	Retrieves a value indicating whether the contrl contains a valid value.
		ValidateAs	Indicates the additional validation is performed, once the user leaves the field.
		Value	Retrieves the control's value with or without literals.
		Version	Retrieves the control's version.
		VisibleMasks	Retrieves or sets a value that indicates the number of visible items in the control masks list.
		VisualAppearance	Retrieves the control's appearance.
		Warning	Indicates the html-tooltip message to be shown when the user enters an invalid character.