UserPreferenceChangingEventHandler Delegate

UserPreferenceChangingEventHandler Delegate


Represents the method that will handle the UserPreferenceChanging event.

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

[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public delegate void UserPreferenceChangingEventHandler(
	object sender,
	UserPreferenceChangingEventArgs e


Type: System.Object

The source of the event. When this event is raised by the SystemEvents class, this object is always null.

Type: Microsoft.Win32.UserPreferenceChangingEventArgs

A UserPreferenceChangedEventArgs that contains the event data.

When you create a UserPreferenceChangingEventHandler delegate, you identify the method that will handle the event. To associate the event with your event-handling method, add an instance of the delegate to the event. The event-handling method is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see NIB: Events and Delegates.

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

using System;
using Microsoft.Win32;

public sealed class App 
    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 
        SystemEvents.PaletteChanged += new 
        SystemEvents.DisplaySettingsChanged += new 

        // 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.");

    // This method is called when a user preference changes.
    static void SystemEvents_UserPreferenceChanging(object sender, UserPreferenceChangingEventArgs e) 
        Console.WriteLine("The user preference is changing. Category={0}", e.Category);

    // This method is called when the palette changes.
    static void SystemEvents_PaletteChanged(object sender, EventArgs e)
        Console.WriteLine("The palette changed.");

    // This method is called when the display settings change.
    static void SystemEvents_DisplaySettingsChanged(object sender, EventArgs e)
        Console.WriteLine("The display settings changed.");

// This code produces the following output.
//  This app is waiting for system events.
//  Press <Enter> to terminate this application.
//  Display Settings changed.
//  User preference is changing. Category=General

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft