SystemEvents Kelas

Definisi

Ruang nama:

Microsoft.Win32

Rakitan:

Microsoft.Win32.SystemEvents.dll

Paket:

Microsoft.Win32.SystemEvents v8.0.0

Sumber:

SystemEvents.cs

Menyediakan akses ke pemberitahuan peristiwa sistem. Kelas ini tidak dapat diwariskan.

public ref class SystemEvents sealed

public sealed class SystemEvents

type SystemEvents = class

Public NotInheritable Class SystemEvents

Warisan

Object

SystemEvents

Contoh

Bagian ini berisi dua contoh. Contoh pertama menunjukkan cara menggunakan peristiwa sistem dalam aplikasi biasa, dan contoh kedua menunjukkan cara menggunakan peristiwa sistem dalam layanan Windows.

Contoh 1

Contoh kode berikut mendaftarkan minat pada beberapa peristiwa sistem dan kemudian menunggu salah satu peristiwa tersebut terjadi. Output yang ditampilkan terjadi jika pengguna mengubah resolusi tampilan.

#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

Contoh 2

Contoh kode berikut menunjukkan layanan Windows yang sangat sederhana yang menangani TimeChanged peristiwa dan UserPreferenceChanged . Contohnya mencakup layanan bernama SimpleService, formulir bernama HiddenForm, dan alat penginstal. Formulir menyediakan perulangan pesan yang diperlukan oleh peristiwa sistem.

Catatan

Layanan tidak memiliki perulangan pesan, kecuali jika diizinkan untuk berinteraksi dengan desktop. Jika perulangan pesan tidak disediakan oleh formulir tersembunyi, seperti dalam contoh ini, layanan harus dijalankan di bawah akun sistem lokal, dan intervensi manual diperlukan untuk mengaktifkan interaksi dengan desktop. Artinya, administrator harus mencentang kotak centang Izinkan layanan berinteraksi dengan desktop secara manual pada tab Masuk dari kotak dialog properti layanan. Dalam hal ini, perulangan pesan secara otomatis disediakan. Opsi ini hanya tersedia ketika layanan dijalankan di bawah akun sistem lokal. Interaksi dengan desktop tidak dapat diaktifkan secara terprogram.

Layanan dalam contoh ini memulai utas yang menjalankan instans HiddenForm. Peristiwa dikaitkan dan ditangani dalam formulir. Peristiwa harus dikaitkan dalam peristiwa beban formulir, untuk memastikan bahwa formulir benar-benar dimuat terlebih dahulu; jika tidak, peristiwa tidak akan dinaikkan.

Catatan

Contohnya menyediakan semua kode yang diperlukan, termasuk kode inisialisasi formulir yang biasanya dihasilkan oleh desainer Visual Studio. Jika Anda mengembangkan layanan di Visual Studio, Anda dapat menghilangkan kelas parsial kedua dan menggunakan jendela Properti untuk mengatur tinggi dan lebar formulir tersembunyi ke nol, gaya batas ke FormBorderStyle.None, dan status jendela ke FormWindowState.Minimized.

Untuk menjalankan contoh:

1. Kompilasi kode dari baris perintah. Nama yang Anda gunakan untuk file sumber tidak penting.

2. Instal layanan dari baris perintah menggunakan utilitas Installutil.exe (Alat Penginstal). Misalnya, InstallUtil example.exe jika nama file sumber adalah example.cs atau example.vb. Anda harus menjadi administrator untuk menginstal layanan.

3. Gunakan konsol Layanan untuk memulai layanan.

4. Ubah waktu sistem, atau ubah preferensi pengguna, seperti properti tetikus.

5. Lihat pesan dalam kategori Aplikasi Pemantau Peristiwa.

6. Gunakan konsol Layanan untuk menghentikan layanan.

7. Hapus instalan layanan dari baris perintah dengan menggunakan /u opsi . Contohnya,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

Keterangan

Kelas ini SystemEvents menyediakan kemampuan untuk menanggapi jenis peristiwa sistem tertentu.

Saat peristiwa sistem dinaikkan, setiap delegasi yang melekat pada peristiwa dipanggil menggunakan utas yang memantau peristiwa sistem. Oleh karena itu, Anda harus melakukan panggilan apa pun dari penanganan aktivitas Anda dengan aman. Jika Anda perlu memanggil peristiwa sistem yang tidak diekspos sebagai anggota kelas ini, Anda dapat menggunakan metode .InvokeOnEventsThread

Perhatian

Jangan melakukan pemrosesan yang memakan waktu pada utas yang meningkatkan penanganan aktivitas sistem karena mungkin mencegah aplikasi lain berfungsi.

Catatan

Beberapa kejadian sistem mungkin tidak dinaikkan pada Windows Vista. Pastikan untuk memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan di Windows Vista.

Metode

CreateTimer(Int32)	Membuat timer jendela baru yang terkait dengan jendela peristiwa sistem.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InvokeOnEventsThread(Delegate)	Memanggil delegasi yang ditentukan menggunakan utas yang mendengarkan peristiwa sistem.
KillTimer(IntPtr)	Mengakhiri timer yang ditentukan oleh id yang diberikan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

DisplaySettingsChanged	Terjadi ketika pengguna mengubah pengaturan tampilan.
DisplaySettingsChanging	Terjadi ketika pengaturan tampilan berubah.
EventsThreadShutdown	Terjadi sebelum utas yang mendengarkan peristiwa sistem dihentikan.
InstalledFontsChanged	Terjadi ketika pengguna menambahkan font ke atau menghapus font dari sistem.
LowMemory	Kedaluwarsa. Terjadi ketika sistem kehabisan RAM yang tersedia.
PaletteChanged	Terjadi ketika pengguna beralih ke aplikasi yang menggunakan palet yang berbeda.
PowerModeChanged	Terjadi ketika pengguna menangguhkan atau melanjutkan sistem.
SessionEnded	Terjadi ketika pengguna keluar atau mematikan sistem.
SessionEnding	Terjadi ketika pengguna mencoba untuk log keluar atau mematikan sistem.
SessionSwitch	Terjadi ketika pengguna yang masuk saat ini telah berubah.
TimeChanged	Terjadi ketika pengguna mengubah waktu pada jam sistem.
TimerElapsed	Terjadi ketika interval pengatur waktu windows telah kedaluwarsa.
UserPreferenceChanged	Terjadi ketika preferensi pengguna telah berubah.
UserPreferenceChanging	Terjadi saat preferensi pengguna berubah.

Lihat juga

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