Atc.Wpf.Controls 3.0.1

ATC.Net WPF

A comprehensive set of modern, enterprise-ready WPF libraries for building professional desktop applications with the MVVM design pattern. This framework provides a rich collection of reusable controls, theming support, font icons, and MVVM infrastructure to accelerate WPF application development.

✨ Key Features

• 🎨 Rich Control Library - 25+ labeled controls, color pickers, selectors, and specialized input controls
• 🌓 Light/Dark Theming - Built-in theme support for all controls with easy customization
• 🎯 MVVM Ready - Complete MVVM infrastructure with observable properties and relay commands
• 🔤 Font Icon Support - Render SVG and image resources based on fonts
• ✅ Smart Validation - Deferred validation pattern for better user experience
• 📐 Advanced Layouts - GridEx, StaggeredPanel, UniformSpacingPanel and more
• 🌍 Localization - Built-in translation and localization support
• 🎭 Value Converters - Extensive collection of XAML value converters

Requirements

• .NET 9 - Desktop Runtime
• Windows 10 or later

NuGet Packages Provided in this Repository

Nuget package	Description	Dependencies
	Base Controls, ValueConverters, Extensions etc.	<ul><li>Atc</li><li>Atc.XamlToolkit</li><li>Atc.XamlToolkit.Wpf</li></ul>
	Miscellaneous UI Controls	<ul><li>Atc.Wpf</li><li>Atc.Wpf.FontIcons</li><li>Atc.Wpf.Theming</li><li>Atc.XamlToolkit</li><li>Atc.XamlToolkit.Wpf</li></ul>
	Controls for creating WPF sample apps	<ul><li>Atc.Wpf</li><li>Atc.Wpf.Theming</li><li>Atc.Wpf.Controls</li></ul>
	Render Svg and Img resources based on fonts	<ul><li>Atc.Wpf</li></ul>
	Theming for Light & Dark mode for WPF base controls	<ul><li>Atc.Wpf</li><li>Atc.XamlToolkit</li><li>Atc.XamlToolkit.Wpf</li></ul>

🔎 Demonstration Application

The demonstration application, Atc.Wpf.Sample, functions as a control explorer. It provides quick visualization of a given control, along with options for copying and pasting the XAML markup and/or the C# code for how to use it.

🎈 Playground and Viewer for a Given Control or Functionality

The following example is taken from the ReplayCommandAsync which illustrates its usage:

• The Sample tab shows how to use the control or feature.
• The XAML tab displays the corresponding XAML markup.
• The CodeBehind tab reveals the underlying code-behind.
• The ViewModel tab displays the associated ViewModel, if used.
• The Readme tab displays the associated [control]_Readme.md, if exist.

Sample	XAML
CodeBehind	ViewModel

🔦 Initial glimpse at the demonstration application

Light-Mode	Dark-Mode
Wpf - AutoGrid	Wpf - AutoGrid
Wpf.Controls - Label MIX	Wpf.Controls - Label MIX
Wpf.Theming - ImageButton	Wpf.Theming - ImageButton
Wpf.FontIcons - Viewer	Wpf.FontIcons - Viewer

🚀 Quick Start Guide

Installation

Add the NuGet packages to your .csproj file:

<ItemGroup>
  <PackageReference Include="Atc.Wpf" Version="2.*" />
  <PackageReference Include="Atc.Wpf.Controls" Version="2.*" />
  <PackageReference Include="Atc.Wpf.FontIcons" Version="2.*" />
  <PackageReference Include="Atc.Wpf.Theming" Version="2.*" />
</ItemGroup>

Configuration

1. Update App.xaml

Add the required resource dictionaries to enable theming and control styles:

<Application
    x:Class="YourApp.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:atc="https://github.com/atc-net/atc-wpf/tree/main/schemas">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                
                <ResourceDictionary Source="pack://application:,,,/Atc.Wpf.Theming;component/Styles/Default.xaml" />

                
                <ResourceDictionary Source="pack://application:,,,/Atc.Wpf.Controls;component/Styles/Controls.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

2. Use Controls in XAML

Now you can use all controls with full theming support:

<Window
    xmlns:atc="https://github.com/atc-net/atc-wpf/tree/main/schemas"
    ...>

    
    <atc:LabelTextBox
        LabelText="User Name"
        Text="{Binding UserName}"
        IsMandatory="True" />

    
    <atc:LabelEndpointBox
        LabelText="API Endpoint"
        NetworkProtocol="Https"
        Value="{Binding EndpointUri}" />

    
    <Button Content="Save" Command="{Binding SaveCommand}" />
    <TextBox Text="{Binding Notes}" />
</Window>

All standard WPF controls (Button, TextBox, ComboBox, etc.) are automatically styled with Light/Dark theme support.

🎯 Label Controls vs Base Controls

Understanding when to use each type of control:

Quick Guideline:

• Use Label Controls for standard forms where you want consistency and less markup
• Use Base Controls when you need custom layouts or are building your own controls

💝 MVVM Made Easy

The Atc.Wpf package provides a complete MVVM infrastructure that makes it easy to separate UI and business logic using the MVVM pattern.

Key MVVM Features

• Observable Properties - Automatic INotifyPropertyChanged implementation
• Relay Commands - Simple command implementation with CanExecute support
• Async Commands - Built-in support for async/await patterns
• Source Generators - Automatic code generation for ViewModels and properties

Learn More

• MVVM Framework Documentation
  • Observable Properties
  • RelayCommands
  • Source Generators

Quick MVVM Example

public partial class MainViewModel : ViewModelBase
{
    [ObservableProperty]
    private string userName = string.Empty;

    [ObservableProperty]
    private bool isEnabled = true;

    [RelayCommand(CanExecute = nameof(CanSave))]
    private async Task SaveAsync()
    {
        await SaveUserDataAsync(UserName);
    }

    private bool CanSave() => !string.IsNullOrEmpty(UserName);
}

📚 Comprehensive Documentation

Note: While this README provides an overview, the best way to explore all controls and components is to run the Atc.Wpf.Sample application, which includes interactive examples with XAML and code-behind for every control! �

💟 Atc.Wpf - Core WPF Library

The foundation library providing essential WPF controls, layouts, and utilities.

Layout Controls

Modern layout panels for advanced UI composition:

• GridEx - Enhanced Grid with auto-row/column generation
• StaggeredPanel - Masonry-style layout panel
• UniformSpacingPanel - Panel with consistent item spacing

Media Controls

• SvgImage - SVG image rendering control

Helpers & Utilities

• PanelHelper - Helper methods for panel layout calculations

Additional Features

• ShaderEffects - HLSL-based visual effects
  • HLSL Shader Compiler Guide
• Translation & Localization - Multi-language support
• ValueConverters - Collection of XAML value converters

💟 Atc.Wpf.Controls - Rich Control Library

A comprehensive collection of specialized WPF controls for enterprise applications.

⭐ Label Controls (25+ Controls)

📖 Complete Label Controls Documentation

Labeled input controls with built-in validation, mandatory indicators, and consistent styling:

• Text Input: LabelTextBox, LabelPasswordBox
• Number Input: LabelIntegerBox, LabelDecimalBox, LabelIntegerXyBox, LabelDecimalXyBox, LabelPixelSizeBox
• Date/Time: LabelDatePicker, LabelTimePicker, LabelDateTimePicker
• Selection: LabelCheckBox, LabelComboBox, LabelToggleSwitch
• Selectors: LabelAccentColorSelector, LabelCountrySelector, LabelFontFamilySelector, LabelLanguageSelector, LabelThemeSelector, LabelWellKnownColorSelector
• Pickers: LabelColorPicker, LabelDirectoryPicker, LabelFilePicker
• Network: LabelEndpointBox (protocol + host + port with validation)
• Display: LabelContent, LabelTextInfo

All label controls support:

• ✅ Deferred validation (shows errors only after user interaction)
• ✅ Mandatory field indicators
• ✅ Consistent styling and theming
• ✅ MVVM-friendly data binding

⭐ Base Controls (14 Controls)

📖 Complete Base Controls Documentation

Unlabeled input controls that provide core functionality without the label wrapper:

• Text Input: RichTextBoxEx
• Number Input: IntegerBox, DecimalBox, IntegerXyBox, DecimalXyBox, PixelSizeBox
• Time Selection: ClockPanelPicker
• Toggle: ToggleSwitch
• Pickers: ColorPicker, DirectoryPicker, FilePicker
• Network: EndpointBox (protocol + host + port with validation)

Base controls are perfect for:

• 🎯 Custom layouts where you position labels yourself
• 🧩 Building composite controls
• 📐 Situations where labels are not needed
• 🔨 Creating your own labeled control wrappers

Color Controls

• WellKnownColorPicker - Predefined color palette picker

Additional Resources

• ValueConverters - Control-specific value converters

💟 Atc.Wpf.FontIcons - Font-Based Icons

Render SVG and image resources using font-based icon systems for crisp, scalable icons.

Features

• 🎨 Scalable vector icons
• 🎯 Font-based rendering
• 📦 Multiple icon font support
• 🌈 Color and size customization

Resources

• ValueConverters - Icon-related value converters

💟 Atc.Wpf.Theming - Light & Dark Mode

Complete theming infrastructure with Light and Dark mode support for all WPF controls.

Features

• 🌓 Light/Dark theme switching
• 🎨 Accent color customization
• 🎯 Automatic control styling
• 🔄 Runtime theme changes
• 📱 Consistent visual design

Resources

• ValueConverters - Theme-aware value converters

🎯 Source Generators

Atc.Wpf includes powerful source generators to reduce boilerplate code:

• ViewModel Generator - Auto-generate ViewModels with observable properties
• DependencyProperty Generator - Auto-generate dependency properties
• AttachedProperty Generator - Auto-generate attached properties

🤝 Contributing

We welcome contributions! Please read our guidelines:

• Contribution Guidelines - How to contribute to ATC projects
• Coding Guidelines - Code style and best practices

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with ❤️ by the ATC.Net team and contributors.

• Visit atc-net.github.io for more ATC projects
• Report issues on GitHub Issues
• Contribute on GitHub