SystemEvents.PaletteChanged Zdarzenie

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

Microsoft.Win32.SystemEvents.dll

Pakiet:

Microsoft.Win32.SystemEvents v8.0.0

Źródło:

SystemEvents.cs

Występuje, gdy użytkownik przełącza się do aplikacji korzystającej z innej palety.

public:
 static event EventHandler ^ PaletteChanged;

public static event EventHandler? PaletteChanged;

member this.PaletteChanged : EventHandler 

Public Shared Custom Event PaletteChanged As EventHandler 

Typ zdarzenia

EventHandler

Wyjątki

InvalidOperationException

Powiadomienia o zdarzeniach systemowych nie są obsługiwane w bieżącym kontekście. Na przykład procesy serwera mogą nie obsługiwać globalnych powiadomień o zdarzeniach systemowych.

ExternalException

Próba utworzenia wątku okna zdarzeń systemowych nie powiodła się.

Przykłady

W poniższym przykładzie kodu pokazano, jak monitorować PaletteChanged zdarzenie. Ten przykład kodu jest częścią większego przykładu podanego SystemEvents dla klasy.

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

Uwagi

Uwaga

To zdarzenie jest zgłaszane tylko wtedy, gdy pompa komunikatów jest uruchomiona. W usłudze systemu Windows, chyba że zostanie użyty ukryty formularz lub pompa komunikatów została uruchomiona ręcznie, to zdarzenie nie zostanie podniesione. Aby zapoznać się z przykładem kodu pokazującym sposób obsługi zdarzeń systemowych przy użyciu ukrytego formularza w usłudze systemu Windows, zobacz klasę SystemEvents .

Przestroga

Ponieważ jest to zdarzenie statyczne, należy odłączyć programy obsługi zdarzeń, gdy aplikacja zostanie usunięta, lub wystąpią przecieki pamięci.