SystemEvents.UserPreferenceChanging Événement

Définition

Espace de noms:

Microsoft.Win32

Assembly:

Microsoft.Win32.SystemEvents.dll

Paquet:

Microsoft.Win32.SystemEvents v8.0.0

Source:

SystemEvents.cs

Se produit lorsqu'une préférence utilisateur est modifiée.

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 

Type d'événement

UserPreferenceChangingEventHandler

Exceptions

InvalidOperationException

Les notifications d'événements système ne sont pas prises en compte dans le contexte actuel. Les processus serveur, par exemple, risquent de ne pas prendre en charge les notifications d'événements système globaux.

ExternalException

La tentative de création d'un thread de fenêtre des événements système a échoué.

Exemples

L’exemple de code suivant montre comment surveiller l’événement UserPreferenceChanging . Cet exemple de code fait partie d’un exemple plus grand fourni pour la SystemEvents classe .

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

Remarques

Notes

Cet événement est déclenché uniquement si la pompe de messages est en cours d’exécution. Dans un service Windows, sauf si un formulaire masqué est utilisé ou que la pompe de messages a été démarrée manuellement, cet événement n’est pas déclenché. Pour obtenir un exemple de code qui montre comment gérer les événements système à l’aide d’un formulaire masqué dans un service Windows, consultez la SystemEvents classe .

Attention

S'agissant d'un événement statique, vous devez détacher vos gestionnaires d’événements lorsque votre application est supprimée, faute de quoi des fuites mémoire vont se produire.

Voir aussi

• UserPreferenceChangingEventArgs
• UserPreferenceChangingEventHandler
• UserPreferenceCategory