Dapplo.Windows

A comprehensive library providing Windows-specific functionality for .NET Framework and .NET Core applications.

Overview

Dapplo.Windows is a collection of packages that provide P/Invoke wrappers and higher-level abstractions for Windows API functionality. Originally developed for Greenshot, this library makes it easy to interact with Windows features from managed code.

Key Features

• Window Management: Query and manipulate windows, monitor window events
• Input Handling: Hook keyboard and mouse events, generate input events
• Clipboard Access: Monitor and manipulate clipboard content with a reactive API
• DPI Awareness: Build DPI-aware applications with automatic scaling
• GDI/User32 Interop: Access to native Windows API functions and structures
• Citrix Support: Detect and interact with Citrix environments
• Desktop Window Manager: Access DWM (Aero) functionality

Package Structure

The library is split into focused packages for better modularity:

Package	Description
Dapplo.Windows	Main package with window management and event hooking
Dapplo.Windows.Clipboard	Clipboard monitoring and manipulation
Dapplo.Windows.Dpi	DPI awareness and scaling support
Dapplo.Windows.Input	Keyboard and mouse input handling
Dapplo.Windows.User32	User32.dll API wrappers
Dapplo.Windows.Gdi32	GDI32.dll API wrappers
Dapplo.Windows.Kernel32	Kernel32.dll API wrappers
Dapplo.Windows.Messages	Windows message definitions
Dapplo.Windows.Citrix	Citrix environment detection
Dapplo.Windows.DesktopWindowsManager	DWM API access
Dapplo.Windows.EmbeddedBrowser	Enhanced WebBrowser control
Dapplo.Windows.Com	COM interop helpers
Dapplo.Windows.Common	Shared types and utilities

Getting Started

Install the packages you need via NuGet:

# For window management and event hooking
Install-Package Dapplo.Windows

# For clipboard functionality
Install-Package Dapplo.Windows.Clipboard

# For DPI awareness
Install-Package Dapplo.Windows.Dpi

# For input handling
Install-Package Dapplo.Windows.Input

Quick Examples

Monitor Window Events

using Dapplo.Windows.Desktop;

// Subscribe to window title changes
var subscription = WinEventHook.Create(WinEvents.EVENT_OBJECT_NAMECHANGE)
    .Subscribe(winEvent =>
    {
        var window = InteropWindow.FromHandle(winEvent.Handle);
        Console.WriteLine($"Window title changed: {window.GetCaption()}");
    });

Monitor Clipboard

using Dapplo.Windows.Clipboard;

// Subscribe to clipboard updates
var subscription = ClipboardNative.OnUpdate
    .Where(info => info.Formats.Contains("Text"))
    .Subscribe(info =>
    {
        using var clipboard = ClipboardNative.Access();
        var text = clipboard.GetAsString();
        Console.WriteLine($"Clipboard text: {text}");
    });

Handle DPI Changes

using Dapplo.Windows.Dpi.Forms;

// Extend DpiAwareForm for automatic DPI scaling
public class MyForm : DpiAwareForm
{
    public MyForm()
    {
        InitializeComponent();
    }
}

Documentation

• Getting Started Guide
• API Reference
• GitHub Repository

Build Status

License

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