SystemEvents Třída

Definice

Obor názvů:

Microsoft.Win32

Sestavení:

Microsoft.Win32.SystemEvents.dll

Balíček:

Microsoft.Win32.SystemEvents v8.0.0

Zdroj:

SystemEvents.cs

Poskytuje přístup k oznámením systémových událostí. Tato třída se nemůže dědit.

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

Dědičnost

Object

SystemEvents

Příklady

Tato část obsahuje dva příklady. První příklad ukazuje, jak používat systémové události v běžné aplikaci, a druhý příklad ukazuje, jak používat systémové události ve službě systému Windows.

Příklad 1

Následující příklad kódu registruje zájem o některé systémové události a pak čeká na výskyt některé z těchto událostí. Zobrazený výstup se zobrazí, pokud uživatel změní rozlišení zobrazení.

#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

Příklad 2

Následující příklad kódu ukazuje velmi jednoduchou službu systému Windows, která zpracovává TimeChanged události a UserPreferenceChanged . Příklad obsahuje službu s názvem SimpleService, formulář s názvem HiddenForma instalační program. Formulář poskytuje smyčku zpráv, kterou vyžadují systémové události.

Poznámka

Služby nemají smyčky zpráv, pokud nemají povolenou interakci s plochou. Pokud smyčka zpráv není poskytnuta skrytým formulářem, jako v tomto příkladu, musí být služba spuštěna pod účtem místního systému a je nutné ruční zásah, aby bylo možné interakci s plochou. To znamená, že správce musí ručně zaškrtnout políčko Povolit službě interakci s plochou na kartě Přihlášení v dialogovém okně vlastností služby. V takovém případě se automaticky poskytne smyčka zpráv. Tato možnost je dostupná jenom v případě, že je služba spuštěná pod účtem místního systému. Interakci s plochou nelze povolit programově.

Služba v tomto příkladu spustí vlákno, které spouští instanci .HiddenForm Události jsou připojeny a zpracovány ve formuláři. Události musí být připojeny v události načtení formuláře, aby se zajistilo, že formulář je zcela načten jako první; jinak se události nevyvolá.

Poznámka

Příklad poskytuje veškerý potřebný kód, včetně inicializačního kódu formuláře, který obvykle vygenerují návrháři sady Visual Studio. Pokud vyvíjíte službu v sadě Visual Studio, můžete vynechat druhou částečnou třídu a pomocí okna Vlastnosti nastavit výšku a šířku skrytého formuláře na nulu, styl ohraničení na FormBorderStyle.Nonea stav okna na FormWindowState.Minimized.

Příklad spustíte takto:

1. Zkompilujte kód z příkazového řádku. Název, který použijete pro zdrojový soubor, není důležitý.

2. Nainstalujte službu z příkazového řádku pomocí nástrojeInstallutil.exe (instalační nástroj). Pokud je example.cs například InstallUtil example.exe název zdrojového souboru nebo example.vb. Abyste mohli službu nainstalovat, musíte být správcem.

3. Ke spuštění služby použijte konzolu Služby.

4. Změňte systémový čas nebo uživatelské předvolby, například vlastnosti myši.

5. Zobrazte zprávy v kategorii Aplikace Prohlížeč událostí.

6. Pomocí konzoly Služby službu zastavte.

7. Odinstalujte službu z příkazového řádku pomocí /u možnosti . Například, 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

Poznámky

Třída SystemEvents poskytuje možnost reagovat na konkrétní typy systémových událostí.

Při vyvolání systémové události jsou všechny delegáty připojené k události volány pomocí vlákna, které monitoruje systémové události. Proto byste měli provádět všechna volání z vašich obslužných rutin událostí bezpečné z více vláken. Pokud potřebujete volat systémovou událost, která není vystavena jako člen této třídy, můžete použít metodu InvokeOnEventsThread .

Upozornění

Neprovádějte časově náročné zpracování vlákna, které vyvolává obslužnou rutinu událostí systému, protože by mohlo bránit fungování jiných aplikací.

Poznámka

Některé systémové události nemusí být vyvolány v systému Windows Vista. Nezapomeňte ověřit, že vaše aplikace funguje podle očekávání v systému Windows Vista.

Metody

CreateTimer(Int32)	Vytvoří nový časovač okna přidružený k okně systémových událostí.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InvokeOnEventsThread(Delegate)	Vyvolá zadaného delegáta pomocí vlákna, které naslouchá událostem systému.
KillTimer(IntPtr)	Ukončí časovač určený daným ID.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

DisplaySettingsChanged	Vyvolá se, když uživatel změní nastavení zobrazení.
DisplaySettingsChanging	Vyvolá se při změně nastavení zobrazení.
EventsThreadShutdown	Vyvolá se před ukončením vlákna, které naslouchá systémovým událostem.
InstalledFontsChanged	Vyvolá se, když uživatel přidá písma do systému nebo je ze systému odebere.
LowMemory	Zastaralé. Vyvolá se v případě, že systému dochází dostupná paměť RAM.
PaletteChanged	Vyvolá se, když uživatel přepne do aplikace, která používá jinou paletu.
PowerModeChanged	Vyvolá se, když uživatel pozastaví nebo obnoví systém.
SessionEnded	Vyvolá se, když se uživatel odhlašuje nebo vypíná systém.
SessionEnding	Vyvolá se, když se uživatel pokouší odhlásit nebo vypnout systém.
SessionSwitch	Vyvolá se při změně aktuálně přihlášeného uživatele.
TimeChanged	Vyvolá se, když uživatel změní čas na systémových hodinách.
TimerElapsed	Vyvolá se při vypršení intervalu časovače windows.
UserPreferenceChanged	Vyvolá se při změně předvolby uživatele.
UserPreferenceChanging	Vyvolá se při změně předvolby uživatele.

Viz také

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