CG.Platform.Presentation 3.10.8

CG.Platform.Presentation

A .NET 10.0 Windows (WPF) presentation library that provides base view models, custom controls, and theme management capabilities. It builds on the CG.Infrastructure presentation stack (Core, Presentation, Navigation) to deliver a consistent WPF application shell with theme, culture, and settings management.

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

Target Framework

• .NET 10.0 Windows (WPF)

Package Information

• Package ID: CG.Platform.Presentation
• Version: 3.10.7
• Product: CG.Platform.Presentation

Dependencies

CG.Infrastructure (required)

• CG.Infrastructure.Core (3.10.8) – Core DI and service registration
• CG.Infrastructure.Presentation (3.10.6) – Base view models, controls, MVVM infrastructure
• CG.Infrastructure.Navigation (3.10.4) – Workspace and tab navigation

Other

• MahApps.Metro: For theme support and Metro-style controls
• CommunityToolkit.Mvvm: For MVVM patterns and commands
• Microsoft.Extensions.DependencyInjection / Hosting / Logging: For DI and logging

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.