SystemEvents Classe

Définition

Espace de noms:

Microsoft.Win32

Assembly:

Microsoft.Win32.SystemEvents.dll

Paquet:

Microsoft.Win32.SystemEvents v8.0.0

Source:

SystemEvents.cs

Fournit l'accès aux notifications d'événements système. Cette classe ne peut pas être héritée.

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

Héritage

Object

SystemEvents

Exemples

Cette section contient deux exemples. Le premier exemple montre comment utiliser des événements système dans une application ordinaire, et le second montre comment utiliser des événements système dans un service Windows.

Exemple 1

L’exemple de code suivant enregistre l’intérêt pour certains événements système, puis attend que l’un de ces événements se produise. La sortie affichée se produit si l’utilisateur modifie la résolution d’affichage.

#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

Exemple 2

L’exemple de code suivant illustre un service Windows très simple qui gère les TimeChanged événements et UserPreferenceChanged . L’exemple inclut un service nommé SimpleService, un formulaire nommé HiddenFormet un programme d’installation. Le formulaire fournit la boucle de message requise par les événements système.

Notes

Les services n’ont pas de boucles de message, sauf s’ils sont autorisés à interagir avec le bureau. Si la boucle de message n’est pas fournie par un formulaire masqué, comme dans cet exemple, le service doit être exécuté sous le compte système local et une intervention manuelle est nécessaire pour activer l’interaction avec le bureau. Autrement dit, l’administrateur doit case activée manuellement la zone Autoriser le service à interagir avec les case activée de bureau sous l’onglet Ouvrir une session de la boîte de dialogue propriétés du service. Dans ce cas, une boucle de message est automatiquement fournie. Cette option est disponible uniquement lorsque le service est exécuté sous le compte système local. L’interaction avec le bureau ne peut pas être activée par programmation.

Le service dans cet exemple démarre un thread qui exécute un instance de HiddenForm. Les événements sont reliés et gérés dans le formulaire. Les événements doivent être connectés dans l’événement de chargement du formulaire, pour s’assurer que le formulaire est entièrement chargé en premier ; sinon, les événements ne seront pas déclenchés.

Notes

L’exemple fournit tout le code nécessaire, y compris le code d’initialisation de formulaire généralement généré par les concepteurs Visual Studio. Si vous développez votre service dans Visual Studio, vous pouvez omettre la deuxième classe partielle et utiliser la fenêtre Propriétés pour définir la hauteur et la largeur du formulaire masqué sur zéro, le style de bordure sur FormBorderStyle.Noneet l’état de la fenêtre sur FormWindowState.Minimized.

Pour exécuter l'exemple :

1. Compilez le code à partir de la ligne de commande. Le nom que vous utilisez pour le fichier source n’est pas important.

2. Installez le service à partir de la ligne de commande à l’aide de l’utilitaire Installutil.exe (Outil d’installation). Par exemple, InstallUtil example.exe si le nom du fichier source est example.cs ou example.vb. Vous devez être administrateur pour installer le service.

3. Utilisez la console Services pour démarrer le service.

4. Modifiez l’heure système ou modifiez les préférences de l’utilisateur, telles que les propriétés de la souris.

5. Affichez les messages dans la catégorie Application de observateur d'événements.

6. Utilisez la console Services pour arrêter le service.

7. Désinstallez le service de la ligne de commande à l’aide de l’option /u . Par exemple : 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

Remarques

La SystemEvents classe offre la possibilité de répondre à des types spécifiques d’événements système.

Lorsqu’un événement système est déclenché, tous les délégués attachés à l’événement sont appelés à l’aide du thread qui surveille les événements système. Par conséquent, vous devez effectuer tous les appels à partir de vos gestionnaires d’événements thread-safe. Si vous devez appeler un événement système qui n’est pas exposé en tant que membre de cette classe, vous pouvez utiliser la InvokeOnEventsThread méthode .

Attention

N’effectuez pas de traitement fastidieux sur le thread qui déclenche un gestionnaire d’événements système, car cela peut empêcher d’autres applications de fonctionner.

Notes

Certains événements système peuvent ne pas être déclenchés sur Windows Vista. Veillez à vérifier que votre application fonctionne comme prévu sur Windows Vista.

Méthodes

CreateTimer(Int32)	Crée une nouvelle minuterie de fenêtre associée à la fenêtre d'événements système.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InvokeOnEventsThread(Delegate)	Appelle le délégué spécifié à l'aide du thread qui écoute les événements système.
KillTimer(IntPtr)	Arrête la minuterie spécifiée par l'ID donné.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

DisplaySettingsChanged	Se produit lorsque l'utilisateur modifie les paramètres d'affichage.
DisplaySettingsChanging	Se produit lorsque les paramètres d'affichage changent.
EventsThreadShutdown	Se produit avant que le thread qui écoute les événements système ne soit terminé.
InstalledFontsChanged	Se produit lorsque l'utilisateur ajoute des polices au système ou en supprime.
LowMemory	Obsolète. Se produit lorsque la mémoire vive devient insuffisante.
PaletteChanged	Se produit lorsque l'utilisateur bascule vers une application qui utilise une palette différente.
PowerModeChanged	Se produit lorsque l'utilisateur interrompt ou redémarre le système.
SessionEnded	Se produit lorsque l'utilisateur ferme une session ou le système.
SessionEnding	Se produit lorsque l'utilisateur essaie de fermer une session ou d'arrêter le système.
SessionSwitch	Se produit lorsque l'utilisateur actuellement connecté a changé.
TimeChanged	Se produit lorsque l'utilisateur modifie l'heure de l'horloge système.
TimerElapsed	Se produit suite à l'expiration d'une minuterie.
UserPreferenceChanged	Se produit lorsqu'une préférence utilisateur est modifiée.
UserPreferenceChanging	Se produit lorsqu'une préférence utilisateur est modifiée.

Voir aussi

• PowerModeChangedEventHandler
• SessionEndedEventHandler
• SessionEndingEventHandler
• SessionSwitchEventHandler
• TimerElapsedEventHandler
• UserPreferenceChangedEventHandler
• UserPreferenceChangingEventHandler