SystemEvents 클래스

정의

시스템 이벤트 알림에 액세스할 수 있도록 합니다.Provides access to system event notifications. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class SystemEvents sealed
public sealed class SystemEvents
type SystemEvents = class
Public NotInheritable Class SystemEvents
상속
SystemEvents

예제

이 섹션에서는 두 가지 예제를 포함합니다.This section contains two examples. 첫 번째 예제에서는 일반 애플리케이션에서 시스템 이벤트를 사용 하 고 두 번째 예제에는 Windows 서비스의 시스템 이벤트를 사용 하는 방법을 보여 줍니다.The first example shows how to use system events in an ordinary application, and the second example shows how to use system events in a Windows service.

예제 1Example 1

다음 코드 예제에서는 일부 시스템 이벤트에 관심을 등록 한 다음 해당 이벤트가 발생할 때까지 기다립니다.The following code example registers interest in some system events and then waits for any of those events to occur. 표시 되는 출력은 사용자가 디스플레이 해상도를 변경 하는 경우에 발생 합니다.The output shown occurs if the user changes the display resolution.

#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

예제 2Example 2

다음 코드 예제에서는 및 이벤트를 처리 하는 매우 간단한 Windows 서비스를 보여 줍니다 TimeChanged UserPreferenceChanged .The following code example demonstrates a very simple Windows service that handles the TimeChanged and UserPreferenceChanged events. 이 예제에는 라는 서비스 SimpleService , 라는 폼 및 설치 관리자가 포함 되어 있습니다 HiddenForm .The example includes a service named SimpleService, a form named HiddenForm, and an installer. 폼은 시스템 이벤트에 필요한 메시지 루프를 제공 합니다.The form provides the message loop that is required by system events.

참고

서비스는 데스크톱과 상호 작용할 수 없는 경우를 제외 하 고는 메시지 루프를 포함 하지 않습니다.Services do not have message loops, unless they are allowed to interact with the desktop. 이 예에서와 같이 메시지 루프를 숨겨진 폼에서 제공 하지 않는 경우에는 로컬 시스템 계정으로 서비스를 실행 해야 하 고 데스크톱과의 상호 작용을 사용 하려면 수동 작업이 필요 합니다.If the message loop is not provided by a hidden form, as in this example, the service must be run under the local system account, and manual intervention is required to enable interaction with the desktop. 즉, 관리자는 서비스 속성 대화 상자의 로그온 탭에서 서비스가 데스크톱과 상호 작용 하도록 허용 확인란을 수동으로 선택 해야 합니다.That is, the administrator must manually check the Allow service to interact with desktop check box on the Log On tab of the service properties dialog box. 이 경우 메시지 루프가 자동으로 제공 됩니다.In that case, a message loop is automatically provided. 이 옵션은 로컬 시스템 계정으로 서비스를 실행 하는 경우에만 사용할 수 있습니다.This option is available only when the service is run under the local system account. 데스크톱과의 상호 작용은 프로그래밍 방식으로 사용 하도록 설정할 수 없습니다.Interaction with the desktop cannot be enabled programmatically.

이 예제의 서비스는 인스턴스를 실행 하는 스레드를 시작 HiddenForm 합니다.The service in this example starts a thread that runs an instance of HiddenForm. 이벤트는 폼에서 후크 되 고 처리 됩니다.The events are hooked up and handled in the form. 양식이 완전히 로드 되도록 하려면 폼의 load 이벤트에서 이벤트를 후크 해야 합니다. 그렇지 않으면 이벤트가 발생 하지 않습니다.The events must be hooked up in the load event of the form, to make sure that the form is completely loaded first; otherwise the events will not be raised.

참고

이 예제에서는 Visual Studio 디자이너에서 일반적으로 생성 하는 폼 초기화 코드를 비롯 하 여 필요한 모든 코드를 제공 합니다.The example provides all the necessary code, including the form initialization code typically generated by Visual Studio designers. Visual Studio에서 서비스를 개발 하는 경우 두 번째 partial 클래스를 생략 하 고 속성 창을 사용 하 여 숨겨진 폼의 높이와 너비를 0으로 설정 하 고 테두리 스타일을로 설정 하 FormBorderStyle.None 고 창 상태를로 설정할 수 있습니다 FormWindowState.Minimized .If you are developing your service in Visual Studio, you can omit the second partial class and use the Properties window to set the height and width of the hidden form to zero, the border style to FormBorderStyle.None, and the window state to FormWindowState.Minimized.

예제를 실행 하려면 다음을 수행 합니다.To run the example:

  1. 명령줄에서 코드를 컴파일합니다.Compile the code from the command line. 원본 파일에 사용 하는 이름은 중요 하지 않습니다.The name that you use for the source file is not important.

  2. Installutil.exe (설치 관리자 도구) 유틸리티를 사용 하 여 명령줄에서 서비스를 설치 합니다.Install the service from the command line using the Installutil.exe (Installer Tool) utility. 예를 들어 InstallUtil example.exe 소스 파일 이름이 또는 인 경우 example.cs 입니다 example.vb .For example, InstallUtil example.exe if the source file name is example.cs or example.vb. 서비스를 설치 하려면 관리자 여야 합니다.You must be an administrator to install the service.

  3. 서비스 콘솔을 사용 하 여 서비스를 시작 합니다.Use the Services console to start the service.

  4. 시스템 시간을 변경 하거나 마우스 속성 등의 사용자 기본 설정을 변경 합니다.Change the system time, or change user preferences, such as mouse properties.

  5. 메시지를 볼 합니다 애플리케이션 이벤트 뷰어의 범주입니다.View the messages in the Application category of Event Viewer.

  6. 서비스 콘솔을 사용 하 여 서비스를 중지 합니다.Use the Services console to stop the service.

  7. 옵션을 사용 하 여 명령줄에서 서비스를 제거 /u 합니다.Uninstall the service from the command line by using the /u option. 예들 들어 InstallUtil /u example.exe입니다.For example, 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클래스는 특정 유형의 시스템 이벤트에 응답 하는 기능을 제공 합니다.The SystemEvents class provides the ability to respond to specific types of system events.

시스템 이벤트가 발생 하면 이벤트에 연결 된 모든 대리자가 시스템 이벤트를 모니터링 하는 스레드를 사용 하 여 호출 됩니다.When a system event is raised, any delegates attached to the event are called using the thread that monitors for system events. 따라서 이벤트 처리기에서 스레드로부터 안전 하 게 호출 해야 합니다.Therefore, you should make any calls from your event handlers thread-safe. 이 클래스의 멤버로 노출 되지 않는 시스템 이벤트를 호출 해야 하는 경우 메서드를 사용할 수 있습니다 InvokeOnEventsThread .If you need to call a system event that is not exposed as a member of this class, you can use the InvokeOnEventsThread method.

주의

다른 애플리케이션의 작동을 방해할 수 있으므로 시스템 이벤트 처리기를 발생 시키는 스레드에서 시간이 많이 걸리는 처리를 수행 하지 않습니다.Do not perform time-consuming processing on the thread that raises a system event handler because it might prevent other applications from functioning.

참고

일부 시스템 이벤트는 Windows Vista에서 발생 하지 않을 수 있습니다.Some system events might not be raised on Windows Vista. Windows Vista에서 응용 프로그램이 예상 대로 작동 하는지 확인 해야 합니다.Be sure to verify that your application works as expected on Windows Vista.

메서드

CreateTimer(Int32)

시스템 이벤트 창과 연결된 새 창 타이머를 만듭니다.Creates a new window timer associated with the system events window.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InvokeOnEventsThread(Delegate)

시스템 이벤트를 수신하는 스레드를 사용하여 지정된 대리자를 호출합니다.Invokes the specified delegate using the thread that listens for system events.

KillTimer(IntPtr)

주어진 ID로 지정된 타이머를 종료합니다.Terminates the timer specified by the given id.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

이벤트

DisplaySettingsChanged

사용자가 디스플레이 설정을 변경할 때 발생됩니다.Occurs when the user changes the display settings.

DisplaySettingsChanging

디스플레이 설정을 변경할 때 발생됩니다.Occurs when the display settings are changing.

EventsThreadShutdown

시스템 이벤트를 수신하는 스레드가 종료되기 전에 발생됩니다.Occurs before the thread that listens for system events is terminated.

InstalledFontsChanged

사용자가 시스템 글꼴을 추가하거나 제거할 때 발생됩니다.Occurs when the user adds fonts to or removes fonts from the system.

LowMemory
사용되지 않습니다.
사용되지 않습니다.
사용되지 않습니다.

시스템에 사용할 수 있는 RAM이 없을 때 발생됩니다.Occurs when the system is running out of available RAM.

PaletteChanged

사용자가 다른 색상표를 사용하는 애플리케이션으로 전환할 때 발생됩니다.Occurs when the user switches to an application that uses a different palette.

PowerModeChanged

사용자가 시스템을 일시 중단하거나 다시 시작할 때 발생됩니다.Occurs when the user suspends or resumes the system.

SessionEnded

사용자가 로그오프하거나 시스템을 종료할 때 발생됩니다.Occurs when the user is logging off or shutting down the system.

SessionEnding

사용자가 로그오프하려고 하거나 시스템을 종료하려고 할 때 발생됩니다.Occurs when the user is trying to log off or shut down the system.

SessionSwitch

현재 로그인한 사용자가 변경될 때 발생합니다.Occurs when the currently logged-in user has changed.

TimeChanged

사용자가 시스템 시계의 시간을 변경할 때 발생됩니다.Occurs when the user changes the time on the system clock.

TimerElapsed

창 타이머 간격 설정이 만료될 때 발생됩니다.Occurs when a windows timer interval has expired.

UserPreferenceChanged

사용자 기본 설정이 변경될 때 발생됩니다.Occurs when a user preference has changed.

UserPreferenceChanging

사용자 기본 설정이 변경될 때 발생됩니다.Occurs when a user preference is changing.

적용 대상

추가 정보