SystemEvents.UserPreferenceChanging Событие

Определение

Пространство имен:

Microsoft.Win32

Сборка:

Microsoft.Win32.SystemEvents.dll

Пакет:

Microsoft.Win32.SystemEvents v11.0.0-preview.7.26381.103

Исходный код:

SystemEvents.cs

Происходит при изменении предпочтения пользователя.

public:
 static event Microsoft::Win32::UserPreferenceChangingEventHandler ^ UserPreferenceChanging;

public static event Microsoft.Win32.UserPreferenceChangingEventHandler? UserPreferenceChanging;

member this.UserPreferenceChanging : Microsoft.Win32.UserPreferenceChangingEventHandler 

Public Shared Custom Event UserPreferenceChanging As UserPreferenceChangingEventHandler 

Тип события

UserPreferenceChangingEventHandler

Исключения

InvalidOperationException

Системные уведомления о событиях не поддерживаются в текущем контексте. Серверные процессы, например, могут не поддерживать уведомления о глобальных системных событиях.

ExternalException

Попытка создать поток окна системных событий не удалось.

Примеры

В следующем примере кода показано, как отслеживать UserPreferenceChanging событие. Этот пример кода является частью более крупного примера, предоставленного для 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

Комментарии

Note

Это событие возникает только в том случае, если выполняется насос сообщений. В службе Windows, если не используется скрытая форма или насос сообщений запущен вручную, это событие не будет возникать. Пример кода, показывающий, как обрабатывать системные события с помощью скрытой формы в службе Windows, см. в SystemEvents этом классе.

Предостережение

Так как это статическое событие, необходимо отключить обработчики событий при удалении приложения или утечки памяти.

См. также раздел

• UserPreferenceChangingEventArgs
• UserPreferenceChangingEventHandler
• UserPreferenceCategory