👁 Image
DoenaSoft.AbstractionLayer.WinForms 2.0.6

DoenaSoft.AbstractionLayer.WinForms

WinForms abstractions that make Windows Forms components easier to mock and unit-test. This project targets multiple frameworks to support legacy .NET Framework and modern .NET desktop applications.

Package Id: DoenaSoft.AbstractionLayer.WinForms

Targets: net472, net8.0-windows, net10.0-windows

Usage:

Install the package from NuGet and program against the provided interfaces instead of concrete WinForms types to make code testable.

License: MIT

Interfaces

This package provides WinForms-specific implementations of the interfaces defined in DoenaSoft.AbstractionLayer.UI. The key interfaces include:

UI Services

• IUIServices - The primary entry point for UI operations. Provides methods to show message boxes and common file/folder dialogs:
  • ShowMessageBox - Display message boxes with configurable text, caption, buttons, and icon
  • ShowOpenFileDialog - Show open file dialogs for single or multiple file selection
  • ShowSaveFileDialog - Show save file dialogs
  • ShowFolderBrowserDialog - Show folder browser dialogs

Clipboard Services

• IClipboardServices - Comprehensive clipboard operations:
  • Contains methods: ContainsText, ContainsAudio, ContainsFileDropList, ContainsImage, ContainsData
  • Get methods: GetText, GetAudioStream, GetFileDropList, GetImage, GetData, GetDataObject
  • Set methods: SetText, SetAudio (byte array or stream), SetFileDropList, SetImage, SetData, SetDataObject
  • Clear method: Clear - Remove all data from clipboard

Thread Synchronization

• ISynchronizer - Invoke work on the UI thread:

  • Invoke(Action) - Synchronously invoke an action on the UI thread
  • Invoke<T>(Func<T>) - Synchronously invoke a function and return its result
  • BeginInvoke(Action) - Asynchronously invoke an action on the UI thread

• IDispatcherOperation - Represents a posted dispatcher operation:

  • Result - Gets the result after completion
  • Status - Gets the current status (Pending, Aborted, Completed, Executing)
  • Task - Gets a Task that represents the operation

Supporting Data Types

Dialog Configuration

• FileDialogOptions - Base configuration for file dialogs
• OpenFileDialogOptions - Configuration for open file dialogs (includes multi-select)
• SaveFileDialogOptions - Configuration for save file dialogs
• FolderBrowserDialogOptions - Configuration for folder browser dialogs

Enumerations

• MessageButton - Message box button configuration (OK, YesNo, YesNoCancel)
• MessageIcon - Message box icon types (None, Information, Warning, Error, Question)
• Result - Dialog result values (OK, Cancel, Yes, No, etc.)
• DispatcherStatus - Dispatcher operation status (Pending, Aborted, Completed, Executing)

Adapters

This package provides concrete WinForms adapter implementations:

• FormUIServices - Wraps System.Windows.Forms dialog types and implements IUIServices
• FormClipboardServices - Wraps System.Windows.Forms.Clipboard and implements IClipboardServices
• FormSynchronizer - Wraps Control.Invoke/BeginInvoke and implements ISynchronizer

Examples

Usage from application code (example view model):

public class MyViewModel
{
 private readonly DoenaSoft.AbstractionLayer.UIServices.IUIServices _ui;
 private readonly DoenaSoft.AbstractionLayer.UIServices.IClipboardServices _clipboard;

 public MyViewModel(
 DoenaSoft.AbstractionLayer.UIServices.IUIServices ui,
 DoenaSoft.AbstractionLayer.UIServices.IClipboardServices clipboard)
 {
 _ui = ui;
 _clipboard = clipboard;
 }

 public void SaveCommand()
 {
 if (_ui.ShowMessageBox("Save changes?", "Confirm", MessageButton.YesNo, MessageIcon.Question) == Result.Yes)
 {
 // perform save
 }
 }

 public void CopyToClipboard(string text)
 {
 if (_clipboard.SetText(text))
 {
 _ui.ShowMessageBox("Copied to clipboard", "Success", MessageButton.OK, MessageIcon.Information);
 }
 }
}

Simple fake for unit tests:

class FakeUIServices : DoenaSoft.AbstractionLayer.UIServices.IUIServices
{
 public Result LastMessageBoxResult { get; set; } = Result.Yes;

 public Result ShowMessageBox(string text, string caption, Buttons buttons, Icon icon)
 {
 return LastMessageBoxResult;
 }

 public bool ShowOpenFileDialog(OpenFileDialogOptions options, out string fileName)
 {
 fileName = "test.txt";
 return true;
 }

 public bool ShowOpenFileDialog(OpenFileDialogOptions options, out string[] fileNames)
 {
 fileNames = new[] { "test.txt" };
 return true;
 }

 public bool ShowSaveFileDialog(SaveFileDialogOptions options, out string fileName)
 {
 fileName = "out.txt";
 return true;
 }

 public bool ShowFolderBrowserDialog(FolderBrowserDialogOptions options, out string folder)
 {
 folder = "C:\\Temp";
 return true;
 }
}

class FakeClipboardServices : DoenaSoft.AbstractionLayer.UIServices.IClipboardServices
{
 public bool ContainsText => true;
 public string ClipboardText { get; set; } = string.Empty;

 public bool ContainsAudio() => false;
 public bool ContainsFileDropList() => false;
 public bool ContainsImage() => false;
 public bool ContainsData(string format) => false;

 public void Clear() => ClipboardText = string.Empty;

 public string GetText() => ClipboardText;
 public Stream GetAudioStream() => null;
 public StringCollection GetFileDropList() => null;
 public object GetImage() => null;
 public object GetData(string format) => null;
 public object GetDataObject() => null;

 public bool SetText(string text)
 {
 ClipboardText = text;
 return true;
 }

 public void SetAudio(byte[] audioBytes) { }
 public void SetAudio(Stream audioStream) { }
 public void SetFileDropList(StringCollection filePaths) { }
 public void SetImage(object image) { }
 public void SetData(string format, object data) { }
 public void SetDataObject(object data, bool copy, int retryTimes, int retryDelay) { }
}

Notes

• This package depends on DoenaSoft.AbstractionLayer.UI version 2.0.1 or later, which contains the contract interfaces and data types.
• The concrete adapter implementations in this package wrap System.Windows.Forms types to implement the UI contracts.
• In production code, use the adapters provided by this package. In unit tests, reference only the contracts package and provide test doubles for the interfaces.
• DoenaSoft.AbstractionLayer.WinForms provides concrete adapters and implementations for those interfaces (for example FormUIServices, FormClipboardServices) that wrap System.Windows.Forms components. In production you reference and use this package; in unit tests you should depend on the contracts (DoenaSoft.AbstractionLayer.UI) and supply test doubles for the interfaces.