SystemEvents Klasa

Definicja

Przestrzeń nazw:

Microsoft.Win32

Zestaw:

Microsoft.Win32.SystemEvents.dll

Pakiet:

Microsoft.Win32.SystemEvents v8.0.0

Źródło:

SystemEvents.cs

Zapewnia dostęp do powiadomień o zdarzeniach systemowych. Klasa ta nie może być dziedziczona.

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

Dziedziczenie

Object

SystemEvents

Przykłady

Ta sekcja zawiera dwa przykłady. W pierwszym przykładzie pokazano, jak używać zdarzeń systemowych w zwykłej aplikacji, a drugi przykład pokazuje, jak używać zdarzeń systemowych w usłudze systemu Windows.

Przykład 1

Poniższy przykład kodu rejestruje zainteresowanie niektórymi zdarzeniami systemowymi, a następnie czeka na wystąpienie dowolnego z tych zdarzeń. Wyświetlane dane wyjściowe są wyświetlane, jeśli użytkownik zmieni rozdzielczość wyświetlania.

#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

Przykład 2

Poniższy przykład kodu przedstawia bardzo prostą usługę systemu Windows, która obsługuje TimeChanged zdarzenia i UserPreferenceChanged . Przykład obejmuje usługę o nazwie , formularz o nazwie SimpleServiceHiddenFormi instalator. Formularz zawiera pętlę komunikatów wymaganą przez zdarzenia systemowe.

Uwaga

Usługi nie mają pętli komunikatów, chyba że mogą korzystać z pulpitu. Jeśli pętla komunikatów nie jest dostarczana przez formularz ukryty, tak jak w tym przykładzie, usługa musi być uruchamiana na lokalnym koncie systemowym, a ręczna interwencja jest wymagana w celu umożliwienia interakcji z pulpitem. Oznacza to, że administrator musi ręcznie zaznaczyć pole wyboru Zezwalaj usłudze na interakcję z pulpitem na karcie Logowanie właściwości usługi okno dialogowe. W takim przypadku jest automatycznie dostarczana pętla komunikatów. Ta opcja jest dostępna tylko wtedy, gdy usługa jest uruchamiana na lokalnym koncie systemowym. Nie można programowo włączyć interakcji z pulpitem.

Usługa w tym przykładzie uruchamia wątek, który uruchamia wystąpienie klasy HiddenForm. Zdarzenia są podłączane i obsługiwane w formularzu. Zdarzenia należy podłączyć w przypadku ładowania formularza, aby upewnić się, że formularz został całkowicie załadowany; w przeciwnym razie zdarzenia nie zostaną podniesione.

Uwaga

W tym przykładzie przedstawiono cały niezbędny kod, w tym kod inicjowania formularzy generowany zazwyczaj przez projektantów programu Visual Studio. Jeśli tworzysz usługę w programie Visual Studio, możesz pominąć drugą klasę częściową i użyć okna Właściwości , aby ustawić wysokość i szerokość ukrytego formularza na zero, styl obramowania na FormBorderStyle.None, a stan okna na FormWindowState.Minimized.

Aby uruchomić przykład:

1. Skompiluj kod z wiersza polecenia. Nazwa używana dla pliku źródłowego nie jest ważna.

2. Zainstaluj usługę z poziomu wiersza polecenia przy użyciu narzędzia Installutil.exe (Narzędzie instalatora ). Jeśli na przykład InstallUtil example.exe nazwa pliku źródłowego to example.cs lub example.vb. Aby zainstalować usługę, musisz być administratorem.

3. Użyj konsoli Usługi, aby uruchomić usługę.

4. Zmień czas systemowy lub zmień preferencje użytkownika, takie jak właściwości myszy.

5. Wyświetl komunikaty w kategorii Aplikacja Podgląd zdarzeń.

6. Użyj konsoli Usług, aby zatrzymać usługę.

7. Odinstaluj usługę z wiersza polecenia przy użyciu /u opcji . Na przykład 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

Uwagi

Klasa SystemEvents zapewnia możliwość reagowania na określone typy zdarzeń systemowych.

Po wywołaniu zdarzenia systemowego wszystkie delegaty dołączone do zdarzenia są wywoływane przy użyciu wątku, który monitoruje zdarzenia systemowe. W związku z tym należy wykonać wszelkie wywołania z modułów obsługi zdarzeń, które są bezpieczne wątkowo. Jeśli musisz wywołać zdarzenie systemowe, które nie jest uwidocznione jako element członkowski tej klasy, możesz użyć InvokeOnEventsThread metody .

Przestroga

Nie należy wykonywać czasochłonnego przetwarzania w wątku, który zgłasza program obsługi zdarzeń systemowych, ponieważ może uniemożliwić działanie innych aplikacji.

Uwaga

Niektóre zdarzenia systemowe mogą nie być wywoływane w systemie Windows Vista. Upewnij się, że aplikacja działa zgodnie z oczekiwaniami w systemie Windows Vista.

Metody

CreateTimer(Int32)	Tworzy nowy czasomierz okna skojarzony z oknem zdarzeń systemowych.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InvokeOnEventsThread(Delegate)	Wywołuje określonego delegata przy użyciu wątku, który nasłuchuje zdarzeń systemowych.
KillTimer(IntPtr)	Przerywa czasomierz określony przez podany identyfikator.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

DisplaySettingsChanged	Występuje, gdy użytkownik zmieni ustawienia wyświetlania.
DisplaySettingsChanging	Występuje, gdy ustawienia wyświetlania zmieniają się.
EventsThreadShutdown	Występuje przed zakończeniem wątku, który nasłuchuje zdarzeń systemowych.
InstalledFontsChanged	Występuje, gdy użytkownik dodaje czcionki do systemu lub usuwa czcionki z systemu.
LowMemory	Przestarzałe. Występuje, gdy system nie ma dostępnej pamięci RAM.
PaletteChanged	Występuje, gdy użytkownik przełącza się do aplikacji korzystającej z innej palety.
PowerModeChanged	Występuje, gdy użytkownik zawiesza się lub wznawia system.
SessionEnded	Występuje, gdy użytkownik wyloguje się lub wyłącza system.
SessionEnding	Występuje, gdy użytkownik próbuje wylogować się lub zamknąć system.
SessionSwitch	Występuje, gdy aktualnie zalogowany użytkownik uległ zmianie.
TimeChanged	Występuje, gdy użytkownik zmienia czas zegara systemowego.
TimerElapsed	Występuje, gdy interwał czasomierza systemu Windows wygasł.
UserPreferenceChanged	Występuje, gdy preferencja użytkownika uległa zmianie.
UserPreferenceChanging	Występuje, gdy preferencja użytkownika się zmienia.

Zobacz też

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