This documentation is archived and is not being maintained.

SystemEvents.PaletteChanged Event

Occurs when the user switches to an application that uses a different palette.

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

public static event EventHandler PaletteChanged
/** @event */
public static void add_PaletteChanged (EventHandler value)

/** @event */
public static void remove_PaletteChanged (EventHandler value)

JScript supports the use of events, but not the declaration of new ones.

Exception typeCondition

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.

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 PaletteChanged 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();
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0
Show: