UserPreferenceChangingEventArgs Class
Provides data for the UserPreferenceChanging event.
Assembly: System (in System.dll)
[HostProtectionAttribute(SecurityAction::LinkDemand, MayLeakOnAbort = true)] [PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")] [PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = "FullTrust")] public ref class UserPreferenceChangingEventArgs : EventArgs
| Name | Description | |
|---|---|---|
![]() | UserPreferenceChangingEventArgs(UserPreferenceCategory) | Initializes a new instance of the UserPreferenceChangingEventArgs class using the specified user preference category identifier. |
| Name | Description | |
|---|---|---|
![]() | Category | Gets the category of user preferences that is changing. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | MemberwiseClone() | |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
A UserPreferenceChanging event occurs when a change to a user preference is about to be applied.
The following code example demonstrates how to use the UserPreferenceChangingEventArgs type to monitor the UserPreferenceChanging event. This code example is part of a larger example provided for the SystemEvents class.
#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
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


