Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 33 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,33 @@
# SfMaskedEdit_GettingStarted_UWP
# UWP Masked TextBox (SfMaskedEdit) – Getting Started Sample

This repository contains a minimal UWP sample that demonstrates the Syncfusion masked input control (SfMaskedEdit) for building validated, formatted user input fields such as phone numbers, dates, currencies, and IP addresses.

The sample showcases how to define masks, set prompt characters and culture, display watermarks, bind values, and handle validation events to deliver a polished input experience on UWP.

## Features
- Define input masks for common patterns (phone, date, time, currency, IP, custom)
- Literal and placeholder handling with configurable PromptChar
- Culture-aware parsing/formatting for region-specific input
- Watermark/placeholder text for guidance when empty
- Data binding to read/write the underlying value
- Basic validation flow with ValueChanging/ValueChanged and completion checks
- Keyboard and touch-friendly editing

## Usage tips
- Choose a PromptChar that fits your design (e.g., underscore or space)
- Bind the control’s value to a view model for validation and storage
- Set Culture to match localized date/time/number formats
- Escape special characters in masks when you need them as literals
- Handle ValueChanging/ValueChanged to intercept or react to edits

## Common mask ideas
- Phone: (000) 000-0000
- Date: 00/00/0000
- Time: 00:00
- Zip/Postal: 00000 or A0A 0A0 (pattern varies by country)
- Currency: $ 000,000.00
- License/Code: AAAA-0000
- IP Address: ###.###.###.###

## About the sample
This sample is a concise starting point for UWP masked input with Syncfusion. Extend it by adding validation rules, localization, and styling to fit your application. For full control capabilities and APIs, refer to the Syncfusion documentation for UWP masked input.