Edit

SystemEvents.DisplaySettingsChanged Event

  • Reference

Definition

Namespace:
Microsoft.Win32
Assembly:
Microsoft.Win32.SystemEvents.dll
Assembly:
System.dll
Package:
Microsoft.Win32.SystemEvents v6.0.0
Package:
Microsoft.Win32.SystemEvents v7.0.0
Package:
Microsoft.Win32.SystemEvents v8.0.0
Package:
Microsoft.Win32.SystemEvents v9.0.0-preview.2.24128.5
Source:
SystemEvents.cs
Source:
SystemEvents.cs
Source:
SystemEvents.cs

Occurs when the user changes the display settings.

public:
 static event EventHandler ^ DisplaySettingsChanged;
public static event EventHandler DisplaySettingsChanged;
public static event EventHandler? DisplaySettingsChanged;
member this.DisplaySettingsChanged : EventHandler 
Public Shared Custom Event DisplaySettingsChanged As EventHandler

Event Type

EventHandler

Exceptions

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.

Examples

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

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

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

'Set the SystemEvents class to receive event notification 
'when a user preference changes, the palette changes, or 
'when display settings change.
AddHandler SystemEvents.UserPreferenceChanging, _
AddressOf SystemEvents_UserPreferenceChanging

AddHandler SystemEvents.PaletteChanged, _
AddressOf SystemEvents_PaletteChanged

AddHandler SystemEvents.DisplaySettingsChanged, _
AddressOf SystemEvents_DisplaySettingsChanged

Remarks

Caution

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

Applies to

See also