SystemEvents.UserPreferenceChanging イベント

.NET Framework クラス ライブラリ リファレンス

SystemEvents.UserPreferenceChanging イベント

ユーザー設定を変更しているときに発生します。

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

Visual Basic (宣言)

Public Shared Event UserPreferenceChanging
 As UserPreferenceChangingEventHandler

Visual Basic (使用法)

Dim handler As UserPreferenceChangingEventHandler

AddHandler SystemEvents.UserPreferenceChanging, handler

C#

public static event UserPreferenceChangingEventHandler
 UserPreferenceChanging

C++

public:
static event UserPreferenceChangingEventHandler^ UserPreferenceChanging
 {
    void add (UserPreferenceChangingEventHandler^ value);
    void remove (UserPreferenceChangingEventHandler^ value);
}

J#

/** @event */
public static void add_UserPreferenceChanging
 (UserPreferenceChangingEventHandler value)

/** @event */
public static void remove_UserPreferenceChanging
 (UserPreferenceChangingEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

例外

例外の種類	条件
InvalidOperationException	システム イベント通知は、現在のコンテキストではサポートされていません。たとえば、サーバー プロセスがグローバル システム イベント通知をサポートしていない可能性があります。
ExternalException	システム イベント ウィンドウ スレッドの作成が成功しませんでした。

解説

注意
これは静的イベントなので、アプリケーションが破棄されるときにイベント ハンドラをデタッチしないと、メモリ リークが発生します。

使用例

UserPreferenceChanging イベントを監視する方法を次のコード例に示します。このコード例は、SystemEvents クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

'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

C#

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();
}

C++

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();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

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

参照

関連項目
SystemEvents クラス
SystemEvents メンバ
Microsoft.Win32 名前空間
UserPreferenceChangingEventArgs
UserPreferenceChangingEventHandler
UserPreferenceCategory