Skip to content

995186-Resolve the ReadMe file length issue in this sample repository #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Dec 1, 2025
Merged

995186-Resolve the ReadMe file length issue in this sample repository #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
42 changes: 40 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,2 +1,40 @@
# WPF-GettingStarted-Databinding
This repository contains that sample that how to add the item using binding concept of WPF SfDomainUpDown control.
# WPF Domain UpDown (SfDomainUpDown) – Getting Started and Data Binding

This sample shows how to use the Syncfusion WPF SfDomainUpDown control to build intuitive, keyboard-friendly pickers for discrete values with full MVVM-friendly data binding. It demonstrates binding to collections, selecting and editing values, wrap/spin behavior, templates for complex items, theming, and best practices for a production-ready experience.

## Features
- Bind to IEnumerable/ObservableCollection for dynamic item lists
- Select values via spin buttons, keyboard, and mouse wheel
- Optional text editing with parsing and read-only modes
- Wrap behavior when spinning past the first/last item
- DisplayMemberPath/ItemTemplate for rich item visualization
- SelectedItem/SelectedIndex two-way binding for MVVM
- Watermark/placeholder and null-value handling
- Theming via Syncfusion built-in visual styles

## Getting Started
1. Create or open a WPF project in Visual Studio (e.g., SfDomainUpDown-GettingStarted).
2. Install the NuGet package: Syncfusion.SfInput.WPF.
- In Visual Studio: Tools > NuGet Package Manager > Manage NuGet Packages for Solution… > Browse “Syncfusion.SfInput.WPF” > Install.
3. Add the Syncfusion XML namespace in your XAML root:
- xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
4. Place an SfDomainUpDown in your Window/Page and bind it to your ViewModel:
- ItemsSource: collection of items to display
- SelectedItem or SelectedIndex: current selection
- DisplayMemberPath or ItemTemplate: how items are shown
- Optional behavior: IsWrapEnabled, IsEditable, SpinButtonAlignment, Watermark
5. Apply a theme if desired using Syncfusion SkinStorage (VisualStyle):
- syncfusion:SkinStorage.VisualStyle="Office2019Colorful" (or any preferred theme)

## Usage Tips
- For complex objects, prefer ItemTemplate or DisplayMemberPath for clear display.
- Use two-way binding on SelectedItem/SelectedIndex to keep the ViewModel in sync.
- Enable IsWrapEnabled for continuous cycling through items.
- Set IsEditable to allow users to type values and handle parsing/validation as needed.
- Align spin buttons via SpinButtonAlignment to suit your layout.
- Provide a Watermark to guide users when no value is selected.
- Handle SelectionChanged to react to user choices (e.g., filtering or commands).

## About the Sample
This sample focuses on the essentials for data binding with SfDomainUpDown: wiring ItemsSource, choosing a selection model, configuring spin and wrap behavior, and theming. Extend it by adding validation rules, custom parsing, commands, and richer item templates to match your application’s workflow and branding.