SystemEvents.PaletteChanged イベント

定義

名前空間:

Microsoft.Win32

アセンブリ:

Microsoft.Win32.SystemEvents.dll

パッケージ:

Microsoft.Win32.SystemEvents v8.0.0

ソース:

SystemEvents.cs

ユーザーが、別のパレットを使用するアプリケーションに切り替えると発生します。

public:
 static event EventHandler ^ PaletteChanged;

public static event EventHandler? PaletteChanged;

member this.PaletteChanged : EventHandler 

Public Shared Custom Event PaletteChanged As EventHandler 

イベントの種類

EventHandler

例外

InvalidOperationException

システム イベント通知は、現在のコンテキストではサポートされていません。 たとえば、サーバー プロセスがグローバル システム イベント通知をサポートしていない可能性があります。

ExternalException

システム イベント ウィンドウ スレッドの作成が成功しませんでした。

例

次のコード例は、イベントを監視する方法を PaletteChanged 示しています。 このコード例は、SystemEvents クラスのために提供されている大規模な例の一部です。

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

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

'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

注釈

注意

このイベントは、メッセージ ポンプが実行されている場合にのみ発生します。 Windows サービスでは、非表示のフォームが使用されているか、メッセージ ポンプが手動で開始されていない限り、このイベントは発生しません。 Windows サービスで非表示のフォームを使用してシステム イベントを処理する方法を示すコード例については、 クラスを SystemEvents 参照してください。

注意事項

これは静的イベントであるため、アプリケーションが破棄されるとイベント ハンドラーをデタッチする必要があります。または、メモリ リークが発生します。