RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
Forms.TSettingChangeEvent Type

TSettingChangeEvent is the type of an OnSettingChange event handler.

Pascal
TSettingChangeEvent = procedure (Sender: TObject; Flag: Integer; const Section: string; var Result: Longint) of object;
C++
(Sender: TObject; Flag: Integer; const Section: string; var Result: Longint) ( TSettingChangeEvent)();

Forms

TSettingChangeEvent has the following parameters: 

Sender is the application object.  

Section indicates the area that contains the system parameter that changed. Typically, this is a registry key or the name of a section in Win.ini. If the notification indicates a policy change, Section is the string 'Policy'. If the notification indicates a change in locale settings, Section is the string 'intl'.  

Result is the value returned to Windows. It should be 0 if the event handler responded to the setting change, nonzero otherwise.  

Flag indicates what setting changed. The following table lists the possible values:  

Value 
Meaning 
0  
A user policy was applied or a user locale setting changed.  
1  
A computer policy was applied.  
SPI_SETDESKWALLPAPER  
The bitmap for the desktop wallpaper changed.  
SPI_SETCURSORS  
The system cursors changed.  
SPI_SETDESKPATTERN  
The desktop pattern was reloaded from Win.ini.  
SPI_SETFONTSMOOTING  
The font smoothing feature was enabled or disabled.  
SPI_SETWORKAREA  
The size of the work area (the portion of the screen not obscured by the system taskbar or desktop toolbars) changed.  
SPI_ICONHORIZONTALSPACING  
The width, in pixels, of an icon cell changed. This affects the arrangement of icons in large icon view.  
SPI_ICONVERTICALSPACING  
The height, in pixels, of an icon cell changed. This affects the arrangement of icons in large icon view.  
SPI_SETICONMETRICS  
The metrics associated with system icons changed.  
SPI_SETICONS  
The system icons were reloaded.  
SPI_SETICONTITLELOGFONT  
The font for icon titles changed.  
SPI_SETICONTITLEWRAP  
Icon title-wrapping was turned on or off.  
SPI_SETBEEP  
The warning beeper was turned on or off.  
SPI_SETDEFAULTINPUTLANG  
The default input language for the system shell changed  
SPI_SETDOUBLECLICKTIME  
The double-click time for the mouse changed.  
SPI_SETDOUBLECLICKHEIGHT  
The height of the double-click rectangle changed.  
SPI_SETDOUBLECLICKWIDTH  
The width of the double-click rectangle changed.  
SPI_SETKEYBOARDCUES  
The setting for whether Menu access key letters appear always or only when the menu is activated from the keyboard changed.  
SPI_SETKEYBOARDDELAY  
The keyboard repeat-delay setting changed.  
SPI_SETKEYBOARDPREF  
The keyboard preference changed. This indicates whether the user wants applications to display hidden keyboard interfaces.  
SPI_SETKEYBOARDSPEED  
The keyboard repeat-speed setting changed.  
SPI_SETLANGTOGGLE  
The hotkey for switching input languages changed.  
SPI_SETMOUSE  
The mouse threshold values or acceleration changed.  
SPI_SETMOUSEBUTTONSWRAP  
The meaning of left and right mouse buttons changed.  
SPI_SETMOUSEHOVERHEIGHT  
The height of the rectangle in which the mouse must stay for mouse hover messages changed.  
SPI_SETMOUSEHOVERTIME  
The time the mouse must stay in the hover rectangle to generate mouse hover messages changed.  
SPI_SETMOUSEHOVERWIDTH  
The width of the rectangle in which the mouse must stay for mouse hover messages changed.  
SPI_SETMOUSESPEED  
The mouse speed changed.  
SPI_SETMOUSETRAILS  
Mouse trails were turned on or off.  
SPI_SETSNAPTODEFBUTTON  
The automatic snapping of the mouse to the default button was turned on or off.  
SPI_SETWHEELSCROLLLINES  
The number of lines to scroll when the mouse wheel rotates changed.  
SPI_SETMENUDROPALIGNMENT  
Popup menus changed between left- and right-alignment.  
SPI_SETMENUFADE  
Menu fade animation was turned on or off (Windows 2K)  
SPI_SETMENUSHOWDELAY  
The delay before displaying a shortcut menu when the mouse is over a submenu item changed.  
SPI_SETLOWPOWERACTIVE  
The low-power phase of screen saving was activated or deactivated.  
SPI_SETLOWPOWERTIMEOUT  
The time period before the low-power phase of screen saving is activated changed.  
SPI_SETPOWEROFFACTIVE  
The power-off phase of screen saving came on or off.  
SPI_SETPOWEROFFTIMEOUT  
The delay before activating the power-off phase of screen saving changed.  
SPI_SETSCREENSAVEACTIVE  
The screen saver was activated or deactivated.  
SPI_SETSCREENSAVETIMEOUT  
The delay before the screen saver appears changed.  
SPI_SETCOMBOBOXANIMATION  
The slide-open effect for combo boxes was turned on or off.  
SPI_SETCURSORSHADOW  
The cursor shadow was turned on or off (Windows 2K).  
SPI_SETGRADIENTCAPTIONS  
The gradient effect on window title bars was turned on or off.  
SPI_SETHOTTRACKING  
Hot-tracking was enabled or disabled.  
SPI_SETLISTBOXSMOOTHSCROLLING  
Smooth scrolling of list boxes was enabled or disabled.  
SPI_SETMENUANIMATION  
Menu animation was enabled or disabled.  
SPI_SETMENUUNDERLINES  
Same as SPI_SETKEYBOARDCUES.  
SPI_SETSELECTIONFADE  
The menu selection fade feature was enabled or disabled. (Windows 2K)  
SPI_SETTOOLTIPANIMATION  
ToolTip animation was enabled or disabled. (Windows 2K)  
SPI_SETTOOLTIPFADE  
ToolTip animation changed between a fade and a slide effect. (Windows 2K)  
SPI_SETUIEFFECTS  
UI effects were enabled or disabled. (Windows 2K)  
SPI_SETACTIVEWINDOWTRACKING  
Active window tracking (where the active window follows the mouse) was enabled or disabled.  
SPI_SETACTIVEWNDTRKZORDER  
Active window tracking changed whether the active window was brought to the top.  
SPI_SETANIMATION  
Parameters to the animation effects for user actions changed.  
SPI_SETBORDER  
The width of a window's sizing border changed.  
SPI_SETCARETWIDTH  
The width of the caret in edit controls changed (Windows 2K)  
SPI_SETDRAGFULLWINDOWS  
Dragging of full windows was turned on or off.  
SPI_SETDRAGHEIGHT  
The height of the rectangle used to detect drag operations changed.  
SPI_SETDRAGWIDTH  
The width of the rectangle used to detect drag operations changed.  
SPI_SETFOREGROUNDFLASHCOUNT  
The number of times a taskbar button flashes when rejecting a foreground switch request changed.  
SPI_SETFOREGROUNDLOCKTIMEOUT  
The time after user input during which applications can't force themselves into the foreground changed.  
SPI_SETMINIMIZEDMETRICS  
The metrics for minimized windows changed.  
SPI_SETNONCLIENTMETRICS  
The metrics for the nonclient area of nonminimized windows changed.  
SPI_SETSHOWIMEUI  
The ability of the IME window to be visible on a per-user basis changed.  
SPI_SETPENWINDOWS  
Pen windows was loaded or unloaded. (Windows 9x)  
SPI_SETACCESSTIMEOUT  
The time-out period for accessibility features changed.  
SPI_SETFILTERKEYS  
The parameters to the FilterKeys accessibility feature changed.  
SPI_SETHIGHCONTRAST  
The parameters to the HighContrast accessibility feature changed.  
SPI_SETMOUSECLICKLOCK  
The mouse ClickLock state was turned on or off. (Windows Me)  
SPI_SETMOUSECLICKLOCKTIME  
The time delay for locking the primary mouse button changed. (Windows Me)  
SPI_SETMOUSEKEYS  
The parameters for the MouseKeys accessibility feature changed.  
SPI_SETMOUSESONAR  
The mouse Sonar feature was turned on or off. (Windows Me)  
SPI_SETMOUSEVANISH  
The mouse Vanish feature was turned on or off. (Windows Me)  
SPI_SETSCREENREADER  
A screen reviewer utility (such as a speech synthesizer or Braille display utility) started or stopped running.  
SPI_SETSERIALKEYS  
The parameters to the SerialKeys accessibility feature changed. (Windows 9x)  
SPI_SETSHOWSOUNDS  
The Show Sounds accessibility feature toggled.  
SPI_SETSOUNDSENTRY  
The parameters to the SoundSentry accessibility feature changed.  
SPI_SETSTICKYKEYS  
The parameters to the StickyKeys feature changed.  
SPI_SETTOGGLEKEYS  
The parameters to the ToggleKeys feature changed.  

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!