SystemEvents.UserPreferenceChanging SystemEvents.UserPreferenceChanging SystemEvents.UserPreferenceChanging SystemEvents.UserPreferenceChanging Event

Definición

Se produce cuando se van a cambiar las preferencias de un usuario.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 

Excepciones

No se admiten las notificaciones de eventos del sistema en el contexto actual.System event notifications are not supported under the current context. Los procesos del servidor, por ejemplo, quizá no admitan las notificaciones globales de eventos del sistema.Server processes, for example, might not support global system event notifications.

No se ha podido crear correctamente un subproceso de ventana de eventos del sistema.The attempt to create a system events window thread did not succeed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo supervisar el UserPreferenceChanging eventos.The following code example demonstrates how to monitor the UserPreferenceChanging event. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para el SystemEvents clase.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

Comentarios

Nota

Este evento se genera solo si se está ejecutando el bombeo de mensajes.This event is only raised if the message pump is running. En un servicio de Windows, a menos que se usa un formulario oculto o se inició manualmente, el bombeo de mensajes no se producirá este evento.In a Windows service, unless a hidden form is used or the message pump has been started manually, this event will not be raised. Para obtener un ejemplo de código que se muestra cómo controlar los eventos del sistema mediante el uso de un formulario oculto en un servicio de Windows, consulte el SystemEvents clase.For a code example that shows how to handle system events by using a hidden form in a Windows service, see the SystemEvents class.

Precaución

Se trata de un evento estático, debe desasociar los controladores de eventos cuando se desecha la aplicación o dará como resultado pérdidas de memoria.Because this is a static event, you must detach your event handlers when your application is disposed, or memory leaks will result.

Se aplica a

Consulte también: