Skip to content

Latest commit

 

History

History
89 lines (75 loc) · 6.27 KB

README.md

File metadata and controls

89 lines (75 loc) · 6.27 KB

Dapplo.Windows

This project contains code which adds Microsoft Windows specific functionality to your .NET Framework or dotnet core 3.x application

  • Documentation can be found here
  • Current build status: Build Status
  • Coverage: Coverage Status
  • Dapplo.Windows: NuGet package
  • Dapplo.Windows.Clipboard: NuGet package
  • Dapplo.Windows.Citrix: NuGet package
  • Dapplo.Windows.Com: NuGet package
  • Dapplo.Windows.Common: NuGet package
  • Dapplo.Windows.DesktopWindowsManager: NuGet package
  • Dapplo.Windows.Dpi: NuGet package
  • Dapplo.Windows.Gdi32: NuGet package
  • Dapplo.Windows.EmbeddedBrowser: NuGet package
  • Dapplo.Windows.Input: NuGet package
  • Dapplo.Windows.Kernel32: NuGet package
  • Dapplo.Windows.Messages: NuGet package
  • Dapplo.Windows.Multimedia: NuGet package
  • Dapplo.Windows.Shell32: NuGet package
  • Dapplo.Windows.User32: NuGet package

This is actually a lot of code I wrote for Greenshot, and with this I am trying to place it into an external repository so it's easier to maintain.

The following functionality is available:

  • Hooking windows events (window moved, changed title etc), mouse & Keyboard
  • Generating key presses or mouse input
  • Clipboard access
  • Getting the title, location etc of windows
  • GDI / User 32 native method mapping
  • Listing installed software
  • A lot of the native structs and enums ... more

Here are some of the packages explained:

Dapplo.Windows.Dpi

This helps to add DPI awareness to your application, and when using Windows.Forms be able to scale with DPI changes. The easiest way is to have your form extend DpiAwareForm or, if you need default scaling use DpiUnwareForm. When you want to handle DPI changes directly, e.g. scale bitmaps, is to use a DpiHandler.

Dapplo.Windows.Messages

Has all the Windows Messages defined for some of the projects in the solution, so if someone uses part of the functionality not everything is included.

Dapplo.Windows.Citrix

A library to add Citrix-Awareness to your application

if (WinFrame.IsAvailble) {
	// Citrix specific code here
	var clientHostname = WinFrame.QuerySessionInformation(InfoClasses.ClientName);
}

Dapplo.Windows.EmbeddedBrowser

Drag ExtendedWebBrowser onto your form, and use it like the normal WebBrowser component. To use the most recent version of the Internet Explorer, call:

InternetExplorerVersion.ChangeEmbeddedVersion();

an example is provided in the Dapplo.Windows.FormsExample project.

Dapplo.Windows.Input

This library helps to process keyboard and mouse input, and can generate keyboard and mouse events. It provides a low-level keyboard / mouse event hook, which is provided as an Observable (Reactive Extensions). There are handlers to be able to react to a key combination, or a sequence of combinations. Examples are provided in the unit-tests here

Dapplo.Windows.Clipboard

In Dapplo.Clipboard specialized code for using the Windows clipboard is place. This is currently being developed and far from ready, it should provide a flexible and fluent API to use the Clipboard. Currently there is already a simplified monitor, using System.Reactive, build in which allows you to subscribe to changes:

	var clipboardSubscription = ClipboardMonitor.OnUpdate.SubscribeOn( < ui SynchronizationContext> ).Where(args => args.Formats.Contains("MyFormat")).Subscribe(args =>
	{
		Debug.WriteLine("Detected my format between these possible formats: {0}", string.Join(",", args.Formats));
	});

This allows you to create simple code which calls you logic if the needed format is available, dispose the subscription when you are ready.

API: ClipboardMonitor should publish a ClipboardContents object for every clipboard event. The ClipboardContents object will get the formats and content at the first moment these are accessed. Need a way to specify the OpenClipboard / CloseClipboard at the rights moments.

GetClipboardData should be used to get the contents, they should be converted to MemoryStreams? The information is stored/maintained, until the ClipboardContents object is disposed? This could be as soon as the next information is placed on the clipboard.