SystemEvents クラス

定義

名前空間:

Microsoft.Win32

アセンブリ:

Microsoft.Win32.SystemEvents.dll

パッケージ:

Microsoft.Win32.SystemEvents v11.0.0-preview.4.26230.115

ソース:

SystemEvents.cs

システム イベント通知へのアクセスを提供します。 このクラスは継承できません。

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

継承

Object

SystemEvents

例

このセクションには、2 つの例が含まれています。 最初の例では、通常のアプリケーションでシステム イベントを使用する方法を示し、2 番目の例は、Windows サービスでシステム イベントを使用する方法を示しています。

例 1

次のコード例では、一部のシステム イベントに関心を登録し、それらのイベントのいずれかが発生するまで待機します。 表示される出力は、ユーザーが表示解像度を変更した場合に発生します。

#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

例 2

次のコード例は、TimeChanged イベントと UserPreferenceChanged イベントを処理する非常に単純なWindows サービスを示しています。 この例には、 SimpleServiceという名前のサービス、 HiddenFormという名前のフォーム、およびインストーラーが含まれています。 フォームには、システム イベントに必要なメッセージ ループが用意されています。

Note

サービスは、デスクトップとの対話が許可されていない限り、メッセージ ループを持っていません。 この例のように、非表示のフォームによってメッセージ ループが提供されない場合は、ローカル システム アカウントでサービスを実行する必要があり、デスクトップとの対話を有効にするには手動による介入が必要です。 つまり、管理者は、サービスのプロパティ ダイアログ ボックスの [ログオン] タブの [デスクトップとの対話をサービスに許可する] チェック ボックスを手動でオンにする必要があります。 その場合、メッセージ ループが自動的に指定されます。 このオプションは、ローカル システム アカウントでサービスが実行されている場合にのみ使用できます。 デスクトップとの対話をプログラムで有効にすることはできません。

この例のサービスは、 HiddenFormのインスタンスを実行するスレッドを開始します。 イベントはフックされ、フォームで処理されます。 フォームが最初に完全に読み込まれるようにするには、フォームの読み込みイベントでイベントをフックする必要があります。それ以外の場合、イベントは発生しません。

Note

この例では、通常、Visual Studio デザイナーによって生成されるフォーム初期化コードを含め、必要なすべてのコードを提供します。 Visual Studioでサービスを開発する場合は、2 番目の部分クラスを省略し、Properties ウィンドウを使用して、非表示フォームの高さと幅をゼロに設定し、罫線のスタイルを FormBorderStyle.None に設定し、ウィンドウの状態を FormWindowState.Minimized に設定できます。

例を実行するには:

1. コマンド ラインからコードをコンパイルします。 ソース ファイルに使用する名前は重要ではありません。

2. Installutil.exe (インストーラー ツール) ユーティリティを使用して、コマンド ラインからサービスをインストールします。 たとえば、ソース ファイル名がInstallUtil example.exeまたはexample.csかどうかをexample.vbします。 サービスをインストールするには、管理者である必要があります。

3. サービス コンソールを使用してサービスを開始します。

4. システム時刻を変更するか、マウスのプロパティなどのユーザー設定を変更します。

5. イベント ビューアーの Application カテゴリでメッセージを表示します。

6. サービス コンソールを使用してサービスを停止します。

7. /u オプションを使用して、コマンド ラインからサービスをアンインストールします。 たとえば、「 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

注釈

SystemEvents クラスは、特定の種類のシステム イベントに応答する機能を提供します。

システム イベントが発生すると、イベントにアタッチされたすべてのデリゲートが、システム イベントを監視するスレッドを使用して呼び出されます。 そのため、スレッド セーフなイベント ハンドラーから任意の呼び出しを行う必要があります。 このクラスのメンバーとして公開されていないシステム イベントを呼び出す必要がある場合は、 InvokeOnEventsThread メソッドを使用できます。

Caution

他のアプリケーションが機能しなくなる可能性があるため、システム イベント ハンドラーを発生させるスレッドで時間のかかる処理を実行しないでください。

Note

一部のシステム イベントは、Windows Vistaで発生しない可能性があります。 アプリケーションがWindows Vistaで想定どおりに動作することを確認してください。

メソッド

名前	説明
CreateTimer(Int32)	システム イベント ウィンドウに関連付けられた新しいウィンドウ タイマーを作成します。
InvokeOnEventsThread(Delegate)	システム イベントをリッスンするスレッドを使用して、指定したデリゲートを呼び出します。
KillTimer(IntPtr)	指定された ID で指定されたタイマーを終了します。

イベント

名前	説明
DisplaySettingsChanged	ユーザーが表示設定を変更したときに発生します。
DisplaySettingsChanging	表示設定が変更されたときに発生します。
EventsThreadShutdown	古い. システム イベントをリッスンするスレッドが終了する前に発生します。
InstalledFontsChanged	ユーザーがシステムにフォントを追加したり、システムからフォントを削除したりしたときに発生します。
LowMemory	古い. システムが使用可能な RAM を使い切ったときに発生します。
PaletteChanged	ユーザーが別のパレットを使用するアプリケーションに切り替えたときに発生します。
PowerModeChanged	ユーザーがシステムを中断または再開したときに発生します。
SessionEnded	ユーザーがシステムをログオフまたはシャットダウンしているときに発生します。
SessionEnding	ユーザーがシステムをログオフまたはシャットダウンしようとしたときに発生します。
SessionSwitch	現在ログインしているユーザーが変更されたときに発生します。
TimeChanged	ユーザーがシステム クロックの時刻を変更したときに発生します。
TimerElapsed	Windows タイマー間隔の有効期限が切れた場合に発生します。
UserPreferenceChanged	ユーザー設定が変更されたときに発生します。
UserPreferenceChanging	ユーザー設定が変更されたときに発生します。

こちらもご覧ください

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