LogoLogo
HomeNewsSupportVideos
  • Introduction
  • Getting Started
  • What's new in 4.0
    • Known Issues
    • .NET Core Designer
    • Managed Graphics
    • Fluent Markup
    • Markdown Support
    • Upgrade from 3.x
  • Releases
    • What's new in 4.0
    • What's new in 3.5
    • What's new in 3.2
      • View Builder
      • Validation Rules
      • Enhanced Font Support
      • Design-Time Debug
    • What's new in 3.1
    • What's new in 3.0
      • FAQs
      • Update Existing Projects
      • Multi Targeting
      • Visual Studio Designer
      • Referencing Assemblies
      • Docker Support
      • Troubleshooting
      • Deployment
    • What's new in 2.5
    • What's new in 2.2
    • What's new in 2.1
    • What's new in 2.0
    • Upgrade from 1.x
  • Getting Started
    • New Project
    • Templates
    • Troubleshooting
    • License Activation
    • FAQ
    • API
    • Hybrid
    • Deployment
    • Theme Builder
  • Concepts
    • Startup
    • Configuration
    • Load Balancing
    • Designer
    • Layouts
    • Client Profiles
    • Tab Order
    • Compression
    • Embedded Resources
    • Modal Workflow
    • Localization
    • RightToLeft
    • Background Tasks
    • Real Time Web Applications
    • JavaScript
    • JavaScript Object Model
    • Security
    • Synchronization
    • Session Management
    • Theming
    • Dependency Injection
    • Application Switches
    • Visual Studio Code
  • Controls & Components
    • General
      • Application
      • AutoSizing
      • AutoScroll
      • AutoScaling
      • Accessibility
      • Colors & Fonts
      • Embedded Tools
      • Events
      • Touch Events
      • Images
      • Labels
      • ToolTips
      • Data Binding
      • Common Properties
      • Custom Painting
      • Move & Resize
      • Drag & Drop
      • Validation
      • User Data
      • Responsive Properties
      • VB.NET Extensions
    • Common Dialogs
      • FolderBrowserDialog
      • ColorDialog
      • OpenFileDialog
      • SaveFileDialog
    • Editors
      • TextBox
        • TagTextBox
        • MaskedTextBox
        • TypedTextBox
      • DateTimePicker
      • MonthCalendar
      • TimeUpDown
      • DomainUpDown
      • NumericUpDown
      • TrackBar
    • Buttons
      • Button
      • SplitButton
      • CheckBox
      • RadioButton
    • Containers
      • Page
      • Form
      • Desktop
      • Panel
      • FlexLayoutPanel
      • FlowLayoutPanel
      • TableLayoutPanel
      • GroupBox
      • Accordion
      • TabControl
      • UserPopup
      • UserControl
      • ToolBar
      • StatusBar
      • SplitContainer
      • SlideBar
    • Lists & Grids
      • ComboBox
        • UserComboBox
        • TreeViewComboBox
        • ListViewComboBox
      • ListBox
        • CheckedListBox
      • TreeView
      • ListView
      • DataGridView
        • Column
        • TextBoxColumn
        • ButtonColumn
        • LinkColumn
        • ImageColumn
        • MaskedTextBoxColumn
        • DateTimePickerColumn
        • NumericUpDownColumn
        • CheckBoxColumn
        • ComboBoxColumn
      • DataRepeater
      • PropertyGrid
    • Extenders
      • Animation
      • ToolTip
      • ErrorProvider
      • Rotation
      • StyleSheet
      • JavaScript
    • Media
      • Audio
      • Video
      • FlashPlayer
    • Content
      • Label
      • LinkLabel
      • PictureBox
      • ScrollBars
      • Upload
      • AspNetPanel
      • ImageList
      • PdfViewer
      • ProgressBar
      • Spacer
      • Widget
      • WebBrowser
      • IFramePanel
      • HtmlPanel
      • Canvas
      • Shape
      • Line
    • Menus
      • MainMenu
      • MenuBar
      • MenuItem
      • LinkMenuItem
      • ContextMenu
    • Notifications
      • AlertBox
      • MessageBox
      • Toast
    • Other Components
      • Timer
      • BindingSource
      • BindingNavigator
      • DataSet
      • EventLog
      • MessageQueue
      • PerformanceCounter
Powered by GitBook
On this page
  • Features
  • Preset Masks
  • Custom Error Handling
  • Text Mask Format
  • How To
  • Customize the Appearance
  • Advanced
  • JavaScript Widget

Was this helpful?

Export as PDF
  1. Controls & Components
  2. Editors
  3. TextBox

MaskedTextBox

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

PreviousTagTextBoxNextTypedTextBox

Last updated 2 months ago

Was this helpful?

The Wisej.NET MaskedTextBox enhances the TextBox control with declarative input validation. The Mask property enables specifying:

  • Required input characters

  • Optional input characters

  • Input type expected at each mask position (digit, alphabetic, alphanumeric)

  • Mask literals (characters appearing directly in the MaskedTextBox, like hyphens in phone numbers or currency symbols)

  • Special character processing (e.g., converting to uppercase)

Features

Preset Masks

The custom mask property editor provides selection from predefined, commonly used masks.

Custom Error Handling

The InvalidMessage property sets a tooltip message for invalid entries.

The TypeValidationCompleted event handler enables custom validation behavior.

Text Mask Format

The TextMaskFormat property determines literal and prompt character processing in the formatted string, controlling their inclusion in the Text property. Excluded prompt characters convert to spaces.

  • ExcludePromptAndLiterals: Shows only user input text

  • IncludeLiterals: Shows user input and mask literal characters

  • IncludePrompt: Shows user input and prompt characters

  • IncludePromptAndLiterals: Shows user input, literal characters, and prompt characters

How To

Customize the Appearance

Customize text color using the ForeColor property.

Advanced

JavaScript Widget

Item
Description

Class name

"wisej.web.MaskedTextBox"

Theme Appearance

"textbox"

Child components

Toolcontainer state

Source code

"textfield" is the inner <input> widget. See

"editor", see

JavaScript
Embedded Tools
https://github.com/iceteagroup/wisej-js
MaskedTextBox mask property editor
MaskedTextBox showing invalid input message
MaskedTextBox with custom validation handling