Wpf

ATC WPF & XAML Toolkit

Two complementary libraries for building enterprise-ready desktop applications:

• Atc.Wpf — 160+ WPF controls, forms, components, theming, and font icons organized in a four-tier architecture
• Atc.XamlToolkit — Cross-platform MVVM foundation with source generators, behaviors, messaging, and value converters supporting WPF, WinUI 3, and Avalonia

Mental model: Atc.XamlToolkit provides the MVVM engine (ViewModelBase, commands, source generators). Atc.Wpf provides the visual building blocks (controls, forms, components, theming). Use them together for WPF; use Atc.XamlToolkit alone for WinUI 3 or Avalonia.

Detailed reference material lives in the references/ folder — load on demand.

References

1. Architecture Overview

Four-Tier Control Architecture (Atc.Wpf)

Additional packages:

Cross-Platform Packages (Atc.XamlToolkit)

2. Quick Start — WPF Application

Step 1: Install packages

<PackageReference Include="Atc.XamlToolkit.Wpf" Version="*" />
<PackageReference Include="Atc.Wpf.Components" Version="*" />
<PackageReference Include="Atc.Wpf.Theming" Version="*" />

Step 2: Create a ViewModel with source generators

// All source generator attributes ([ObservableProperty], [RelayCommand], [ComputedProperty],
// [DependencyProperty], [AttachedProperty], [RoutedEvent], [ObservableDtoViewModel])
// live in the Atc.XamlToolkit.Mvvm namespace — same as ViewModelBase.
// Do NOT use Atc.XamlToolkit.SourceGenerators.Attributes — that namespace does not exist.
using Atc.XamlToolkit.Mvvm;

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

    [ObservableProperty]
    private int age;

    [RelayCommand]
    private async Task SaveAsync(CancellationToken cancellationToken)
    {
        IsBusy = true;
        // Save logic here
        IsBusy = false;
    }
}

This generates:

• Name property with INotifyPropertyChanged
• Age property with INotifyPropertyChanged
• SaveCommand async command property with cancellation support

Step 3: Use themed window and controls

<theming:NiceWindow x:Class="MyApp.MainWindow"
    xmlns:theming="clr-namespace:Atc.Wpf.Theming.Windows;assembly=Atc.Wpf.Theming"
    xmlns:forms="clr-namespace:Atc.Wpf.Forms.Controls;assembly=Atc.Wpf.Forms"
    xmlns:controls="clr-namespace:Atc.Wpf.Controls.BaseControls;assembly=Atc.Wpf.Controls">

    <StackPanel>
        <forms:LabelTextBox LabelText="Name" Value="{Binding Name}" />
        <forms:LabelIntegerBox LabelText="Age" Value="{Binding Age}" />
        <Button Content="Save" Command="{Binding SaveCommand}" />
    </StackPanel>
</theming:NiceWindow>

3. Source Generators

All generators work at compile time — zero runtime reflection.

RelayCommand with Cancellation

[RelayCommand(SupportsCancellation = true)]
private async Task LoadDataAsync(CancellationToken cancellationToken)
{
    // Long-running operation
}

Generates: LoadDataCommand, LoadDataCancelCommand, and CancelLoadData() method.

ObservableDtoViewModel

[ObservableDtoViewModel(typeof(PersonDto))]
public partial class PersonViewModel : ViewModelBase { }

Generates a full ViewModel wrapping PersonDto with:

• All properties with change notification
• IsDirty tracking
• InnerModel access to the underlying DTO
• Method proxies
• Validation attribute copying

See Source Generators for all options and platform-specific details.

4. Controls Quick Reference

Input Controls

NumericBox, IntegerBox, DecimalBox, CurrencyBox, ToggleSwitch, RangeSlider, Rating, FilePicker, DirectoryPicker

Buttons

ImageButton, SplitButton, AuthenticationButton, ConnectivityButton

Color Controls

HueSlider, SaturationBrightnessPicker, TransparencySlider, WellKnownColorPicker

Data Display

Alert, Card, Badge, Chip, Avatar, AvatarGroup, Divider, Carousel, Breadcrumb, Stepper, Segmented, Timeline, Popover

Layout Panels

GridEx, AutoGrid, FlexPanel, StaggeredPanel, UniformSpacingPanel, ResponsivePanel, DockPanelPro

Selectors

CountrySelector, LanguageSelector, FontFamilySelector, DualListSelector

Progress & Loading

BusyOverlay, LoadingIndicator, Overlay, Skeleton

25+ Labeled Form Controls

LabelTextBox, LabelIntegerBox, LabelDecimalBox, LabelComboBox, LabelDatePicker, LabelColorPicker, LabelToggleSwitch, LabelFilePicker, LabelDirectoryPicker, and more — each with built-in label, validation, and consistent styling.

Composite Components

InfoDialogBox, QuestionDialogBox, InputDialogBox, InputFormDialogBox, ColorPickerDialogBox, BasicApplicationSettingsDialogBox, Flyout, FlyoutHost, JsonViewer, TerminalViewer, ToastNotification, PrintPreviewWindow, UndoRedoHistoryView

See Control Catalog for the full inventory.

5. Theming

NiceWindow — themed window replacement with built-in title bar, minimize/maximize/close buttons, Light/Dark mode support:

<theming:NiceWindow x:Class="MyApp.MainWindow" ... >

ThemeSelector — built-in control for switching themes:

<theming:ThemeSelector />

AccentColorSelector — pick accent color:

<theming:AccentColorSelector />

See Theming & Icons.

6. Font Icons

Six icon families available via Atc.Wpf.FontIcons:

Usage in XAML:

<fontIcons:FontIcon IconType="FontAwesome5Solid" IconName="fa-check" FontSize="16" />

7. MVVM Infrastructure

ViewModelBase Built-in Properties

Commands

Messaging System

// Send
Messenger.Default.Send(new GenericMessage<string>("Hello"));

// Receive
Messenger.Default.Register<GenericMessage<string>>(this, msg => { ... });

Message types: GenericMessage<T>, NotificationMessage, PropertyChangedMessage<T>, NotificationMessageAction.

Services

See MVVM Infrastructure.

8. Behaviors

Cross-platform behaviors (WPF, WinUI 3, Avalonia):

36+ Value Converters

Bool converters, string converters, null converters, visibility converters, and multi-value converters. See Behaviors & Converters.

9. Network Scanning

Atc.Wpf.Network provides a NetworkScannerView control for IP scanning, port scanning, and device discovery. Requires Atc.Network package.

10. Requirements