From 6e1726864c5edca0603dbd5e7df5d4cdde04f7a2 Mon Sep 17 00:00:00 2001
From: Raghav-Sudhakar <raghavendra.s@syncfusion.com>
Date: Sun, 30 Nov 2025 15:56:06 +0530
Subject: [PATCH] 995186-Resolve the ReadMe file length issue in this sample
 repository

---
 README.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 6c6300d..df88b49 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,33 @@
-# SfMaskedEdit_GettingStarted_UWP
\ No newline at end of file
+# 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.