MobileForms Toolkit Documentation

MaskedTextBox Class

Uses a mask to distinguish between proper and improper user input.

For a list of all members of this type, see MaskedTextBox Members.

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.TextBoxBase
               System.Windows.Forms.TextBox
                  Resco.Controls.MaskedTextBox.MaskedTextBox

public class MaskedTextBox : TextBox

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Remarks

The MaskedTextBox class is an enhanced TextBox control that supports a declarative syntax for accepting or rejecting user input. Using the Mask property, you can specify the following input without writing any custom validation logic in your application:

When a MaskedTextBox control is displayed at run time, it represents the mask as a series of prompt characters and optional literal characters. Each editable mask position, representing a required or optional input, is shown with a single prompt character. For example, the number sign (#) is often used as a placeholder for a numeric character input. You can use the PromptChar property to specify a custom prompt character. The HidePromptOnLeave property determines if the user sees the prompt characters when the control loses input focus.

As the user types input into the masked text box, valid input characters replace their respective prompt characters in a sequential fashion. If the user types an invalid input character, no replacement occurs, but instead a beep is issued if the BeepOnError property is set to true.

The arrow keys can be used to navigate to a previous or subsequent position.

The Text property will always retrieve the user's input formatted according to the mask and the TextMaskFormat property.

The MaskedTextBox control actually defers all mask processing to the MaskedTextProvider class specified by the MaskedTextProvider property.

Requirements

Namespace: Resco.Controls.MaskedTextBox

Assembly: Resco.DetailView.CF3 (in Resco.DetailView.CF3.dll)

See Also

MaskedTextBox Members | Resco.Controls.MaskedTextBox Namespace