SystemEventsとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

SystemEvents イベント

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

参照

SystemEvents クラス

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

名前空間: Microsoft.Win32
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SystemEvents

Visual Basic (使用法)

Dim instance As SystemEvents

public sealed class SystemEvents

C++

public ref class SystemEvents sealed

public final class SystemEvents

JScript

public final class SystemEvents

解説

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

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

メモ
このクラスに適用される HostProtectionAttribute 属性には、Resources プロパティ値として MayLeakOnAbort が設定されています。HostProtectionAttribute は、デスクトップアプリケーション (通常、アイコンのダブルクリック、コマンドの入力、またはブラウザへの URL の入力により起動されるもの) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

メモ

このクラスに適用される HostProtectionAttribute 属性には、Resources プロパティ値として MayLeakOnAbort が設定されています。HostProtectionAttribute は、デスクトップアプリケーション (通常、アイコンのダブルクリック、コマンドの入力、またはブラウザへの URL の入力により起動されるもの) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

システムイベントに対象を登録してイベントの発生を待機するコード例を次に示します。ここに示す出力は、ユーザーがディスプレイ解像度を変更した場合に発生します。

Visual Basic

Imports System
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 Not (components Is
 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

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

C++

#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

.NET Framework のセキュリティ

NamedPermissionSet (システムリソースへのフルアクセスに必要なアクセス許可)。LinkDemand (要求値)。FullTrust (関連する状態)。

継承階層

System.Object
Microsoft.Win32.SystemEvents

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SystemEvents メンバ
Microsoft.Win32 名前空間
PowerModeChangedEventHandler デリゲート
SessionEndedEventHandler デリゲート
SessionEndingEventHandler デリゲート
SessionSwitchEventHandler デリゲート
TimerElapsedEventHandler
UserPreferenceChangedEventHandler
UserPreferenceChangingEventHandler

SystemEvents メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	CreateTimer	システムイベントウィンドウに関連付けられた新しいウィンドウタイマを作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InvokeOnEventsThread	システムイベントを待機するスレッドを使って指定したデリゲートを呼び出します。
	KillTimer	特定の ID によって指定されたタイマが終了します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

SystemEvents メンバ

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

SystemEvents データ型で公開されるメンバを以下の表に示します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	CreateTimer	システムイベントウィンドウに関連付けられた新しいウィンドウタイマを作成します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InvokeOnEventsThread	システムイベントを待機するスレッドを使って指定したデリゲートを呼び出します。
	KillTimer	特定の ID によって指定されたタイマが終了します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリックイベント

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