Vcl.Forms.TSettingChangeEvent

From RAD Studio API Documentation
Jump to: navigation, search

C++

typedef void __fastcall (__closure *TSettingChangeEvent)(System::TObject* Sender, int Flag, const System::UnicodeString Section, int &Result);

Properties

Type Visibility Source Unit Parent
typedef public Vcl.Forms.hpp Vcl.Forms Vcl.Forms

Description

TSettingChangeEvent is the type of an OnSettingChange event handler.

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.



See Also