Mode Settings in Windows Forms MaskedTextBox (MaskedEditBox)

This section discusses how to set the different mode to the MaskedEditBox control.

The mode settings for the MaskedEditBox control can be customized by using the ClipMode, InputMode and UsageMode properties.

MaskedEditBox Properties Description
ClipMode Specifies the format of the text that will be returned by the MaskedEdit control. The options included are as follows.

IncludeLiterals and

ExcludeLiterals.

The default value is 'IncludeLiterals'.
InputMode Specifies the input mode for the MaskedEditBox control. The options included are as follows.

OvertypeOnly and

Normal.

The default value is 'Over typeOnly'.
UsageMode Specifies if the MaskedEditBox control is to behave as a numeric control.

Clip mode

At runtime, we can copy or paste the entries of MaskedEditBox. The entries that are copied can be specified whether to include literals using the ClipMode property.

Setting the ClipMode property of the MaskedEditBox to ExcludeLiterals, will get rid of the literals from the text that is returned by the control. The default value is set to IncludeLiterals.

InputMode

The different modes of the input can be determined by the InputMode property.

Setting the InputMode to Normal, allows the user to work in insert mode and the INSERT key is not allowed. In Over typeOnly mode, the INSERT key will not have any effect.

UsageMode

The UsageMode property modifies the behavior of the MaskedEditBox as detailed below.

Normal mode

When the UsageMode is set to Normal, there is no change in the behavior. This is the default mode for a MaskedEditBox control.

Numeric mode

When the UsageMode is set to Numeric, the control creates internally two data groups and one decimal separator character in the mask. These groups are created such that the first group holds the mask value before the decimal separator and the second group holds the mask value after the decimal separator. For example, let us specify the mask as follows:

###.####

The first group will contain the value for the first 3 ### characters of the mask (the number group) and the second group (the decimal group) will contain the 5 characters (.####). The default group alignment for the number group will be right and the alignment for the decimal group will be left. Refer to the information on DataGroups for more information on how this works.

The MaxValue and MinValue properties are enforced only when the UsageMode is set to Numeric.

this.maskedEditBox1.ClipMode = Syncfusion.Windows.Forms.Tools.ClipModes.ExcludeLiterals;
this.maskedEditBox1.InputMode = Syncfusion.Windows.Forms.Tools.MaskInputMode.Normal;
this.maskedEditBox1.UsageMode = Syncfusion.Windows.Forms.Tools.MaskedUsageMode.Numeric;
Me.maskedEditBox1.ClipMode = Syncfusion.Windows.Forms.Tools.ClipModes.ExcludeLiterals
Me.maskedEditBox1.InputMode = Syncfusion.Windows.Forms.Tools.MaskInputMode.Normal
Me.maskedEditBox1.UsageMode = Syncfusion.Windows.Forms.Tools.MaskedUsageMode.Numeric