Provides access to Windows system event notifications. Commonly Used Types: Microsoft.Win32.SystemEvents
$ dotnet add package Microsoft.Win32.SystemEventsProvides support for accessing Windows system event notifications, which can be crucial for applications to respond to changes in the system or user environment.
Through this assembly, applications can subscribe to a set of global system events provided by the SystemEvents class, gaining the ability to react to changes like system power mode alterations, user preference modifications, and session switches, among others.
An example of how to use the SystemEvents class to react to system changes:
using Microsoft.Win32;
// Set the SystemEvents class to receive event notification when a user
// preference changes, the palette changes, or when display settings change.
SystemEvents.UserPreferenceChanging += UserPreferenceChanging;
SystemEvents.PaletteChanged += PaletteChanged;
SystemEvents.DisplaySettingsChanged += DisplaySettingsChanged;
// For demonstration purposes, this application sits idle waiting for events.
Console.WriteLine("This application is waiting for system events.");
Console.WriteLine("Press <Enter> to terminate this application.");
Console.ReadLine();
// This method is called when a user preference changes.
static void UserPreferenceChanging(object sender, UserPreferenceChangingEventArgs e)
{
Console.WriteLine($"The user preference is changing. Category={e.Category}");
}
// This method is called when the palette changes.
static void PaletteChanged(object sender, EventArgs e)
{
Console.WriteLine("The palette changed.");
}
// This method is called when the display settings change.
static void DisplaySettingsChanged(object sender, EventArgs e)
{
Console.WriteLine("The display settings changed.");
}
In this example, the methods will be invoked whenever the user modifies one of several system settings.
<!-- The main types provided in this library --> <!-- Links to further documentation. Remove conceptual documentation if not available for the library. --> <!-- How to provide feedback on this package and contribute to it -->The main types provided by this library are:
Microsoft.Win32.SystemEventsMicrosoft.Win32.PowerModeChangedEventHandlerMicrosoft.Win32.SessionEndedEventHandlerMicrosoft.Win32.UserPreferenceChangedEventHandlerMicrosoft.Win32.SystemEvents is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.