CG.Platform.Presentation 3.10.6

Platform.Presentation

A WPF presentation library that provides base view models, custom controls, and theme management capabilities.

Features

• Base View Models: Common MVVM patterns and base classes
• Custom Controls: Reusable WPF controls
• Theme Management: Dynamic MahApps.Metro theme switching
• Culture Management: Multi-language support with culture switching
• Settings Persistence: Application settings management with JSON storage

Getting Started

Installation

dotnet add package CG.Platform.Presentation

Basic Setup

<Application x:Class="YourApp.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                
                <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Controls.xaml" />
                <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Fonts.xaml" />
                <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Themes/Light.Blue.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

// Program.cs or App.xaml.cs
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Platform.Presentation.Extensions;

var services = new ServiceCollection();

// Add logging
services.AddLogging(builder =>
{
    builder.AddConsole();
    builder.AddDebug();
});

// Register platform services (includes theme, culture, and settings services)
services.RegisterPlatformServices(configuration);

var serviceProvider = services.BuildServiceProvider();

Theme Management

The library provides dynamic theme switching using MahApps.Metro themes.

Available Themes

• Light Themes: Light.Blue, Light.Green, Light.Orange, Light.Purple, Light.Red, Light.Steel
• Dark Themes: Dark.Blue, Dark.Green, Dark.Orange, Dark.Purple, Dark.Red, Dark.Steel

Using Theme Service

public class MainViewModel
{
    private readonly IThemeService _themeService;

    public MainViewModel(IThemeService themeService)
    {
        _themeService = themeService;
    }

    public void SwitchToDarkTheme()
    {
        _themeService.SetTheme("Dark.Blue");
    }

    public IEnumerable<string> GetAvailableThemes()
    {
        return _themeService.GetAvailableThemes();
    }
}

Theme Switching in XAML

<ComboBox ItemsSource="{Binding AvailableThemes}"
          SelectedItem="{Binding SelectedTheme}"
          SelectionChanged="OnThemeChanged" />

Culture Management

The library supports multi-language applications with culture switching.

Supported Cultures

• English: en-US, en-GB
• Spanish: es-ES, es-MX
• French: fr-FR, fr-CA
• German: de-DE, de-AT
• Italian: it-IT
• Portuguese: pt-BR, pt-PT
• Russian: ru-RU
• Asian Languages: ja-JP, ko-KR, zh-CN, zh-TW

Using Culture Service

public class MainViewModel
{
    private readonly ICultureService _cultureService;

    public MainViewModel(ICultureService cultureService)
    {
        _cultureService = cultureService;
    }

    public void SwitchToSpanish()
    {
        _cultureService.SetCulture("es-ES");
    }

    public IEnumerable<CultureInfo> GetAvailableCultures()
    {
        return _cultureService.GetAvailableCultures();
    }
}

Settings Management

The library provides persistent application settings with JSON storage.

Using Settings Service

public class MainViewModel
{
    private readonly ISettingsService _settingsService;

    public MainViewModel(ISettingsService settingsService)
    {
        _settingsService = settingsService;
        
        // Load saved settings
        var savedTheme = _settingsService.GetSetting("SelectedTheme", "Light.Blue");
        var savedLanguage = _settingsService.GetSetting("SelectedLanguage", "en-US");
    }

    public void SaveSettings()
    {
        _settingsService.SetSetting("SelectedTheme", "Dark.Blue");
        _settingsService.SetSetting("SelectedLanguage", "es-ES");
        _settingsService.SaveSettings();
    }
}

Settings Flyout

The library includes a pre-built settings flyout for theme and culture management.

Using Settings Flyout

<mah:Flyout Header="Settings" 
             Position="Right" 
             IsOpen="{Binding IsSettingsOpen}">
    <views:SettingsFlyoutView />
</mah:Flyout>

public class MainViewModel
{
    public bool IsSettingsOpen { get; set; }
    
    public void OpenSettings()
    {
        IsSettingsOpen = true;
    }
}

Service Registration

All services are automatically registered when using RegisterPlatformServices():

• IThemeService → ThemeService
• ICultureService → CultureService
• ISettingsService → SettingsService
• SettingsFlyoutViewModel

Configuration

Settings are automatically stored in the user's AppData folder:

• Path: %APPDATA%\Platform.Presentation\settings.json
• Format: JSON with automatic serialization/deserialization

Dependencies

• MahApps.Metro: For theme support and Metro-style controls
• CommunityToolkit.Mvvm: For MVVM patterns and commands
• Microsoft.Extensions.Logging: For logging support
• System.Text.Json: For settings persistence

Examples

See the SettingsFlyoutView and SettingsFlyoutViewModel for a complete example of theme and culture management in a WPF application.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

License

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