VirtualDesktop 5.0.5
dotnet add package VirtualDesktop --version 5.0.5
NuGet\Install-Package VirtualDesktop -Version 5.0.5
<PackageReference Include="VirtualDesktop" Version="5.0.5" />
paket add VirtualDesktop --version 5.0.5
#r "nuget: VirtualDesktop, 5.0.5"
// Install VirtualDesktop as a Cake Addin #addin nuget:?package=VirtualDesktop&version=5.0.5 // Install VirtualDesktop as a Cake Tool #tool nuget:?package=VirtualDesktop&version=5.0.5
VirtualDesktop
VirtualDesktop is C# wrapper for IVirtualDesktopManager on Windows 11 (and Windows 10).
Features
- Switch, add, and remove a virtual desktop.
- Move the window in the same process to any virtual desktop.
- Move the window of another process to any virtual desktop (Support in version 2.0 or later).
- Pin any window or application; will be display on all desktops.
- Notification for switching, deletion, renaming, etc.
- Change the wallpaper for each desktop.
Sample app
samples/VirtualDesktop.Showcase
Requirements
<TargetFramework>net5.0-windows10.0.19041.0</TargetFramework>
- .NET 5 or 6
- Windows 10 build 19041 (20H1) or later
Installation
Install NuGet package(s).
PM> Install-Package VirtualDesktop
- VirtualDesktop - Core classes for VirtualDesktop.
- VirtualDesktop.WPF - Provides extension methods for WPF Window class.
- VirtualDesktop.WinForms - Provides extension methods for Form class.
How to use
Preparation
Because of the dependency on C#/WinRT (repo), the target framework must be set to net5.0-windows10.0.19041.0
or later.
<TargetFramework>net5.0-windows10.0.19041.0</TargetFramework>
<TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
If it doesn't work, try creating an app.manifest
file and optimize to work on Windows 10.
<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
<application>
<supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
</application>
</compatibility>
The namespace to use is WindowsDesktop
.
using WindowsDesktop;
Get instance of VirtualDesktop class
// Get all virtual desktops
var desktops = VirtualDesktop.GetDesktops();
// Get Virtual Desktop for specific window
var desktop = VirtualDesktop.FromHwnd(hwnd);
// Get the left/right desktop
var left = desktop.GetLeft();
var right = desktop.GetRight();
Manage virtual desktops
// Create new
var desktop = VirtualDesktop.Create();
// Remove
desktop.Remove();
// Switch
desktop.GetLeft().Switch();
Subscribe virtual desktop events
// Notification of desktop switching
VirtualDesktop.CurrentChanged += (_, args) => Console.WriteLine($"Switched: {args.NewDesktop.Name}");
// Notification of desktop creating
VirtualDesktop.Created += (_, desktop) => desktop.Switch();
for WPF window
// Need to install 'VirtualDesktop.WPF' package
// Check whether a window is on the current desktop.
var isCurrent = window.IsCurrentVirtualDesktop();
// Get Virtual Desktop for WPF window
var desktop = window.GetCurrentDesktop();
// Move window to specific Virtual Desktop
window.MoveToDesktop(desktop);
// Pin window
window.Pin()
See also:
License
This library is under the MIT License.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0-windows10.0.19041 is compatible. net6.0-windows was computed. net6.0-windows10.0.19041 is compatible. net7.0-windows was computed. net8.0-windows was computed. |
-
net5.0-windows10.0.19041
- Microsoft.CodeAnalysis.CSharp (>= 4.0.1)
-
net6.0-windows10.0.19041
- Microsoft.CodeAnalysis.CSharp (>= 4.0.1)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on VirtualDesktop:
Package | Downloads |
---|---|
VirtualDesktop.WPF
C# Wrapper for the Virtual Desktop API on Windows 11 (and Windows 10). |
|
VirtualDesktop.WinForms
C# Wrapper for the Virtual Desktop API on Windows 11 (and Windows 10). |
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on VirtualDesktop:
Repository | Stars |
---|---|
glsorre/amethystwindows
[ARCHIVED] Automatic tiling window manager for Windows 10/11
|
|
m0ngr31/VirtualDesktopManager
|
Version | Downloads | Last updated |
---|---|---|
5.0.5 | 3,318 | 2/7/2022 |
5.0.4 | 580 | 2/6/2022 |
5.0.3 | 477 | 2/6/2022 |
5.0.2 | 475 | 2/6/2022 |
5.0.1 | 470 | 2/5/2022 |
5.0.0 | 519 | 2/5/2022 |
4.0.1 | 2,267 | 3/22/2020 |
4.0.0 | 1,084 | 3/22/2020 |
3.0.0-beta1 | 866 | 9/11/2018 |
2.0.0-beta3 | 3,937 | 8/6/2016 |
2.0.0-beta2 | 1,113 | 8/6/2016 |
2.0.0-beta | 1,505 | 8/3/2016 |
1.0.3 | 3,603 | 12/15/2015 |
1.0.2 | 1,721 | 12/15/2015 |
1.0.1 | 1,232 | 12/15/2015 |
1.0.0 | 2,009 | 12/15/2015 |