SystemEvents Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona acceso a notificaciones de eventos del sistema. Esta clase no puede heredarse.
public ref class SystemEvents sealedpublic sealed class SystemEventstype SystemEvents = classPublic NotInheritable Class SystemEvents- Herencia
-
SystemEvents
Ejemplos
Esta sección contiene dos ejemplos. En el primer ejemplo se muestra cómo usar eventos del sistema en una aplicación normal y el segundo ejemplo muestra cómo usar eventos del sistema en un servicio de Windows.
Ejemplo 1
En el ejemplo de código siguiente se registra interés en algunos eventos del sistema y, a continuación, se espera a que se produzca alguno de esos eventos. La salida que se muestra se produce si el usuario cambia la resolución de pantalla.
#using <System.dll>
using namespace System;
using namespace Microsoft::Win32;
// This method is called when a user preference changes.
void SystemEvents_UserPreferenceChanging(Object^ sender,
UserPreferenceChangingEventArgs^ e)
{
Console::WriteLine("The user preference is changing. Category={0}",
e->Category);
}
// This method is called when the palette changes.
void SystemEvents_PaletteChanged(Object^ sender, EventArgs^ e)
{
Console::WriteLine("The palette changed.");
}
// This method is called when the display settings change.
void SystemEvents_DisplaySettingsChanged(Object^ sender,
EventArgs^ e)
{
Console::WriteLine("The display settings changed.");
}
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();
}
// This code produces the following output.
//
// This app is waiting for system events.
// Press <Enter> to terminate this application.
// Display Settings changed.
// User preference is changing. Category=General
using System;
using Microsoft.Win32;
public sealed class App
{
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();
}
// This method is called when a user preference changes.
static void SystemEvents_UserPreferenceChanging(object sender, UserPreferenceChangingEventArgs e)
{
Console.WriteLine("The user preference is changing. Category={0}", e.Category);
}
// This method is called when the palette changes.
static void SystemEvents_PaletteChanged(object sender, EventArgs e)
{
Console.WriteLine("The palette changed.");
}
// This method is called when the display settings change.
static void SystemEvents_DisplaySettingsChanged(object sender, EventArgs e)
{
Console.WriteLine("The display settings changed.");
}
}
// This code produces the following output.
//
// This app is waiting for system events.
// Press <Enter> to terminate this application.
// Display Settings changed.
// User preference is changing. Category=General
Imports Microsoft.Win32
Imports System.Windows.Forms
Friend Class Form1
Inherits System.Windows.Forms.Form
Public Sub New()
MyBase.New()
'This call is required by the Windows Form Designer.
InitializeComponent()
'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
End Sub
'Form overrides dispose to clean up the component list.
Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
If disposing Then
If (components IsNot Nothing) Then
components.Dispose()
End If
End If
MyBase.Dispose(disposing)
End Sub
Private components As System.ComponentModel.IContainer
<System.Diagnostics.DebuggerStepThrough()> Private Sub InitializeComponent()
Me.SuspendLayout()
'
'Form1
'
Me.ClientSize = New System.Drawing.Size(648, 398)
Me.Name = "Form1"
Me.Text = "Form1"
Me.ResumeLayout(False)
End Sub
' This method is called when a user preference changes.
Private Sub SystemEvents_UserPreferenceChanging( _
ByVal sender As Object, _
ByVal e As UserPreferenceChangingEventArgs)
MessageBox.Show("UserPreferenceChanging: " & _
e.Category.ToString())
End Sub
' This method is called when the palette changes.
Private Sub SystemEvents_PaletteChanged( _
ByVal sender As Object, _
ByVal e As EventArgs)
MessageBox.Show("PaletteChanged")
End Sub
' This method is called when the display settings change.
Private Sub SystemEvents_DisplaySettingsChanged( _
ByVal sender As Object, _
ByVal e As EventArgs)
MessageBox.Show("The display settings changed.")
End Sub
End Class
Ejemplo 2
En el ejemplo de código siguiente se muestra un servicio de Windows muy sencillo que controla los TimeChanged eventos y UserPreferenceChanged . En el ejemplo se incluye un servicio denominado SimpleService, un formulario denominado HiddenFormy un instalador. El formulario proporciona el bucle de mensajes que requieren los eventos del sistema.
Nota
Los servicios no tienen bucles de mensajes, a menos que se les permita interactuar con el escritorio. Si un formulario oculto no proporciona el bucle de mensajes, como en este ejemplo, el servicio debe ejecutarse en la cuenta del sistema local y se requiere la intervención manual para habilitar la interacción con el escritorio. Es decir, el administrador debe activar manualmente la casilla Permitir que el servicio interactúe con el escritorio en la pestaña Iniciar sesión del cuadro de diálogo propiedades del servicio. En ese caso, se proporciona automáticamente un bucle de mensajes. Esta opción solo está disponible cuando el servicio se ejecuta en la cuenta del sistema local. La interacción con el escritorio no se puede habilitar mediante programación.
El servicio de este ejemplo inicia un subproceso que ejecuta una instancia de HiddenForm. Los eventos se enlazan y controlan en el formulario. Los eventos se deben enlazar en el evento de carga del formulario, para asegurarse de que el formulario se carga completamente primero; de lo contrario, los eventos no se generarán.
Nota
En el ejemplo se proporciona todo el código necesario, incluido el código de inicialización del formulario generado normalmente por los diseñadores de Visual Studio. Si va a desarrollar el servicio en Visual Studio, puede omitir la segunda clase parcial y usar la ventana Propiedades para establecer el alto y el ancho del formulario oculto en cero, el estilo de borde en FormBorderStyle.Noney el estado de la ventana en FormWindowState.Minimized.
Para ejecutar el ejemplo:
Compile el código desde la línea de comandos. El nombre que se usa para el archivo de origen no es importante.
Instale el servicio desde la línea de comandos mediante la utilidad Installutil.exe (Herramienta instalador). Por ejemplo,
InstallUtil example.exesi el nombre del archivo de origen esexample.csoexample.vb. Debe ser administrador para instalar el servicio.Use la consola servicios para iniciar el servicio.
Cambie la hora del sistema o cambie las preferencias del usuario, como las propiedades del mouse.
Vea los mensajes en la categoría Aplicación de Visor de eventos.
Use la consola servicios para detener el servicio.
Desinstale el servicio de la línea de comandos mediante la
/uopción . Por ejemplo,InstallUtil /u example.exe.
using System;
using System.ServiceProcess;
using System.Threading;
using System.Windows.Forms;
using System.Diagnostics;
using Microsoft.Win32;
using System.ComponentModel;
using System.Configuration.Install;
namespace SimpleServiceCs
{
public class SimpleService : ServiceBase
{
static void Main(string[] args)
{
ServiceBase.Run(new SimpleService());
}
protected override void OnStart(string[] args)
{
EventLog.WriteEntry("SimpleService", "Starting SimpleService");
new Thread(RunMessagePump).Start();
}
void RunMessagePump()
{
EventLog.WriteEntry("SimpleService.MessagePump", "Starting SimpleService Message Pump");
Application.Run(new HiddenForm());
}
protected override void OnStop()
{
Application.Exit();
}
}
public partial class HiddenForm : Form
{
public HiddenForm()
{
InitializeComponent();
}
private void HiddenForm_Load(object sender, EventArgs e)
{
SystemEvents.TimeChanged += new EventHandler(SystemEvents_TimeChanged);
SystemEvents.UserPreferenceChanged += new UserPreferenceChangedEventHandler(SystemEvents_UPCChanged);
}
private void HiddenForm_FormClosing(object sender, FormClosingEventArgs e)
{
SystemEvents.TimeChanged -= new EventHandler(SystemEvents_TimeChanged);
SystemEvents.UserPreferenceChanged -= new UserPreferenceChangedEventHandler(SystemEvents_UPCChanged);
}
private void SystemEvents_TimeChanged(object sender, EventArgs e)
{
EventLog.WriteEntry("SimpleService.TimeChanged", "Time changed; it is now " +
DateTime.Now.ToLongTimeString());
}
private void SystemEvents_UPCChanged(object sender, UserPreferenceChangedEventArgs e)
{
EventLog.WriteEntry("SimpleService.UserPreferenceChanged", e.Category.ToString());
}
}
partial class HiddenForm
{
private System.ComponentModel.IContainer components = null;
protected override void Dispose(bool disposing)
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}
private void InitializeComponent()
{
this.SuspendLayout();
this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.ClientSize = new System.Drawing.Size(0, 0);
this.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None;
this.Name = "HiddenForm";
this.Text = "HiddenForm";
this.WindowState = System.Windows.Forms.FormWindowState.Minimized;
this.Load += new System.EventHandler(this.HiddenForm_Load);
this.FormClosing += new System.Windows.Forms.FormClosingEventHandler(this.HiddenForm_FormClosing);
this.ResumeLayout(false);
}
}
[RunInstaller(true)]
public class SimpleInstaller : Installer
{
private ServiceInstaller serviceInstaller;
private ServiceProcessInstaller processInstaller;
public SimpleInstaller()
{
processInstaller = new ServiceProcessInstaller();
serviceInstaller = new ServiceInstaller();
// Service will run under system account
processInstaller.Account = ServiceAccount.LocalSystem;
// Service will have Start Type of Manual
serviceInstaller.StartType = ServiceStartMode.Automatic;
serviceInstaller.ServiceName = "Simple Service";
Installers.Add(serviceInstaller);
Installers.Add(processInstaller);
}
}
}
Imports System.ServiceProcess
Imports System.Threading
Imports System.Windows.Forms
Imports System.Diagnostics
Imports Microsoft.Win32
Imports System.ComponentModel
Imports System.Configuration.Install
Namespace SimpleServiceVb
Public Class SimpleService
Inherits ServiceBase
Shared Sub Main(ByVal args() As String)
ServiceBase.Run(New SimpleService())
End Sub
Protected Overrides Sub OnStart(ByVal args() As String)
EventLog.WriteEntry("SimpleService", "Starting SimpleService")
Dim t As New Thread(AddressOf RunMessagePump)
t.Start()
End Sub
Sub RunMessagePump()
EventLog.WriteEntry("SimpleService.MessagePump", _
"Starting SimpleService Message Pump")
Application.Run(New HiddenForm())
End Sub
Protected Overrides Sub OnStop()
Application.Exit()
End Sub
End Class
Partial Class HiddenForm
Inherits Form
Public Sub New()
InitializeComponent()
End Sub
Private Sub HiddenForm_Load(ByVal sender As Object, ByVal e As EventArgs)
AddHandler SystemEvents.TimeChanged, AddressOf SystemEvents_TimeChanged
AddHandler SystemEvents.UserPreferenceChanged, AddressOf SystemEvents_UPCChanged
End Sub
Private Sub HiddenForm_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
RemoveHandler SystemEvents.TimeChanged, New EventHandler(AddressOf SystemEvents_TimeChanged)
RemoveHandler SystemEvents.UserPreferenceChanged, _
New UserPreferenceChangedEventHandler(AddressOf SystemEvents_UPCChanged)
End Sub
Private Sub SystemEvents_TimeChanged(ByVal sender As Object, ByVal e As EventArgs)
EventLog.WriteEntry("SimpleService.TimeChanged", _
"Time changed; it is now " & DateTime.Now.ToLongTimeString())
End Sub
Private Sub SystemEvents_UPCChanged(ByVal sender As Object, ByVal e As UserPreferenceChangedEventArgs)
EventLog.WriteEntry("SimpleService.UserPreferenceChanged", e.Category.ToString())
End Sub
End Class
Partial Class HiddenForm
Private components As System.ComponentModel.IContainer = Nothing
Protected Overrides Sub Dispose(ByVal disposing As Boolean)
If disposing AndAlso Not (components Is Nothing) Then
components.Dispose()
End If
MyBase.Dispose(disposing)
End Sub
Private Sub InitializeComponent()
Me.SuspendLayout()
Me.AutoScaleDimensions = New System.Drawing.SizeF(6F, 13F)
Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font
Me.ClientSize = New System.Drawing.Size(0, 0)
Me.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None
Me.Name = "HiddenForm"
Me.Text = "HiddenForm"
Me.WindowState = System.Windows.Forms.FormWindowState.Minimized
AddHandler Me.Load, AddressOf Me.HiddenForm_Load
AddHandler Me.FormClosing, AddressOf Me.HiddenForm_FormClosing
Me.ResumeLayout(False)
End Sub
End Class
<RunInstaller(True)> _
Public Class SimpleInstaller
Inherits Installer
Private serviceInstaller As ServiceInstaller
Private processInstaller As ServiceProcessInstaller
Public Sub New()
processInstaller = New ServiceProcessInstaller()
serviceInstaller = New ServiceInstaller()
' Service will run under system account
processInstaller.Account = ServiceAccount.LocalSystem
' Service will have Start Type of Manual
serviceInstaller.StartType = ServiceStartMode.Automatic
serviceInstaller.ServiceName = "Simple Service"
Installers.Add(serviceInstaller)
Installers.Add(processInstaller)
End Sub
End Class
End Namespace
Comentarios
La SystemEvents clase proporciona la capacidad de responder a tipos específicos de eventos del sistema.
Cuando se genera un evento del sistema, se llama a los delegados adjuntos al evento mediante el subproceso que supervisa los eventos del sistema. Por lo tanto, debe realizar cualquier llamada desde los controladores de eventos seguros para subprocesos. Si necesita llamar a un evento del sistema que no se expone como miembro de esta clase, puede usar el InvokeOnEventsThread método .
Precaución
No realice un procesamiento lento en el subproceso que genera un controlador de eventos del sistema porque podría impedir que otras aplicaciones funcionen.
Nota
Es posible que algunos eventos del sistema no se generen en Windows Vista. Asegúrese de comprobar que la aplicación funciona según lo previsto en Windows Vista.
Métodos
| CreateTimer(Int32) |
Crea un nuevo temporizador de ventana asociado a la ventana de eventos del sistema. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InvokeOnEventsThread(Delegate) |
Invoca al delegado especificado mediante el subproceso que escucha eventos del sistema. |
| KillTimer(IntPtr) |
Termina el temporizador especificado por el identificador dado. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| DisplaySettingsChanged |
Se produce cuando el usuario cambia la configuración de pantalla. |
| DisplaySettingsChanging |
Se produce cuando la configuración de pantalla está cambiando. |
| EventsThreadShutdown |
Se produce antes de que finalice el subproceso que escucha los eventos del sistema. |
| InstalledFontsChanged |
Se produce cuando el usuario agrega o quita fuentes del sistema. |
| LowMemory |
Obsoletos.
Obsoletos.
Obsoletos.
Se produce cuando el sistema se queda sin RAM disponible. |
| PaletteChanged |
Se produce cuando el usuario cambia a una aplicación que utiliza una paleta diferente. |
| PowerModeChanged |
Se produce cuando el usuario suspende o reanuda el sistema. |
| SessionEnded |
Se produce cuando el usuario cierra una sesión o apaga el sistema. |
| SessionEnding |
Se produce cuando el usuario intenta cerrar una sesión o apagar el sistema. |
| SessionSwitch |
Se produce cuando el usuario registrado actualmente ha cambiado. |
| TimeChanged |
Se produce cuando el usuario cambia la hora en el reloj del sistema. |
| TimerElapsed |
Se produce cuando ha expirado el intervalo del temporizador de Windows. |
| UserPreferenceChanged |
Se produce cuando han cambiado las preferencias de un usuario. |
| UserPreferenceChanging |
Se produce cuando se van a cambiar las preferencias de un usuario. |
