Export (0) Print
Expand All

SystemEvents.UserPreferenceChanging Event

Occurs when a user preference is changing.

Namespace:  Microsoft.Win32
Assembly:  System (in System.dll)

public static event UserPreferenceChangingEventHandler UserPreferenceChanging

ExceptionCondition
InvalidOperationException

System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications.

ExternalException

The attempt to create a system events window thread did not succeed.

NoteNote

This event is only raised if the message pump is running. In a Windows service, unless a hidden form is used or the message pump has been started manually, this event will not be raised. For a code example that shows how to handle system events by using a hidden form in a Windows service, see the SystemEvents class.

Caution noteCaution

Because this is a static event, you must detach your event handlers when your application is disposed, or memory leaks will result.

The following code example demonstrates how to monitor the UserPreferenceChanging event. This code example is part of a larger example provided for the SystemEvents class.

static void Main() 
{         
    // Set the SystemEvents class to receive event notification when a user  
    // preference changes, the palette changes, or when display settings change.
    SystemEvents.UserPreferenceChanging += new 
        UserPreferenceChangingEventHandler(SystemEvents_UserPreferenceChanging);
    SystemEvents.PaletteChanged += new 
        EventHandler(SystemEvents_PaletteChanged);
    SystemEvents.DisplaySettingsChanged += new 
        EventHandler(SystemEvents_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();
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft