SystemEvents.UserPreferenceChanging Ereignis

Definition

Tritt ein, wenn sich eine Benutzereinstellung ändert.Occurs when a user preference is changing.

public:
 static event Microsoft::Win32::UserPreferenceChangingEventHandler ^ UserPreferenceChanging;
public static event Microsoft.Win32.UserPreferenceChangingEventHandler UserPreferenceChanging;
member this.UserPreferenceChanging : Microsoft.Win32.UserPreferenceChangingEventHandler 
Public Shared Custom Event UserPreferenceChanging As UserPreferenceChangingEventHandler 

Ausnahmen

Systemereignisbenachrichtigungen werden unter dem aktuellen Kontext nicht unterstützt.System event notifications are not supported under the current context. Beispielsweise unterstützen Serverprozesse möglicherweise keine globalen Systemereignisbenachrichtigungen.Server processes, for example, might not support global system event notifications.

Beim Versuch, einen Thread für das Systemereignisfenster zu erstellen, ist ein Fehler aufgetreten.The attempt to create a system events window thread did not succeed.

Beispiele

Im folgenden Codebeispiel wird das Überwachen des UserPreferenceChanging Ereignisses veranschaulicht.The following code example demonstrates how to monitor the UserPreferenceChanging event. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SystemEvents-Klasse bereitgestellt wird.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

Hinweise

Hinweis

Dieses Ereignis wird nur ausgelöst, wenn das nachrichtenpump ausgeführt wird.This event is only raised if the message pump is running. In einem Windows-Dienst wird dieses Ereignis nicht ausgelöst, es sei denn, es wird ein ausgeblendetes Formular verwendet, oder das nachrichtenpump wurde manuell gestartet.In a Windows service, unless a hidden form is used or the message pump has been started manually, this event will not be raised. Ein Codebeispiel, das zeigt, wie Systemereignisse mithilfe eines verborgenen Formulars in einem Windows-Dienst behandelt werden, finden Sie in der SystemEvents-Klasse.For a code example that shows how to handle system events by using a hidden form in a Windows service, see the SystemEvents class.

Achtung

Da es sich hierbei um ein statisches Ereignis handelt, müssen Sie die Ereignishandler trennen, wenn die Anwendung verworfen wird, oder die Arbeitsspeicher Verluste entstehen.Because this is a static event, you must detach your event handlers when your application is disposed, or memory leaks will result.

Gilt für:

Siehe auch