MaskedTextBox.ResetOnSpace Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets or sets a value that determines how a space input character should be handled.

public:
 property bool ResetOnSpace { bool get(); void set(bool value); };

public bool ResetOnSpace { get; set; }

member this.ResetOnSpace : bool with get, set

Public Property ResetOnSpace As Boolean

Property Value

Boolean

true if the space input character causes the current editable position in the mask to be reset; otherwise, false to indicate that it is to be processed as a normal input character. The default is true.

Remarks

The MaskedTextBox can treat two categories of characters - spaces and prompt characters - specially. Typically, each input character will be tested against the mask and either accepted or rejected. Setting the ResetOnSpace property to true will result in the current mask character position to be cleared and the current position to be advanced to the next editable character.

The type of character input will determine whether the masking engine moves forward to the next character in the mask, or stays at the current position and waits for a matching character. If the input character is a space, and does not match the current non-editable character in the mask, the masking engine will skip ahead to the next character in the mask. If the input character is not a space, and does not match the current non-editable character in the mask, the masking engine will remain at the current mask position, and attempt to match the next input character against it.

See also

• ResetOnPrompt