网站首页  词典首页

请输入您要查询的函数：

　

术语 systemparametersinfo
释义 SystemParametersInfo
语法：
C++
BOOL WINAPI SystemParametersInfo(
__in UINT uiAction,
__in UINT uiParam,
__inout PVOID pvParam,
__in UINT fWinIni
);
SystemParametersInfo函数
获取或设置一个全系统的参数值。此功能还可以更新用户配置文件，同时设置参数。
参数
uiAction [in]
全系统参数进行检索或设置。可能的值是组织相关参数如下表：
辅助功能参数
台式机参数
图标参数
输入参数
菜单参数
电力参数
屏幕保护程序的参数
超时参数
界面效应参数
窗口参数
以下是获取参数。
无障碍parameterMeaning
SPI_GETACCESSTIMEOUTRetrieves信息超时期间与相关的辅助功能。该pvParam参数必须指向一个ACCESSTIMEOUT结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(ACCESSTIMEOUT)。
SPI_GETAUDIODESCRIPTIONDetermines音频描述是否启用或禁用。该pvParam参数是一个AUDIODESCRIPTION结构的指针。设置这个结构cbSize成员和uiParam参数为sizeof(AUDIODESCRIPTION)。
虽然用户有视觉障碍谁听到的音频视频内容可能有一个在视频不具有相应的音频很多交易行动。具体什么是发生在一个视频音频介绍帮助这些用户更好地了解的内容。这个标志使您能够确定是否音频说明已启用，并在其中的语言。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_GETCLIENTAREAANIMATIONDetermines动画是否启用或禁用。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果动画被禁用，或否则返回FALSE。
显示功能，如闪光，闪烁，闪烁和移动的内容可能会导致与光敏用户癫痫发作。这个标志使您能够确定动画是否已在客户区禁用。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_GETDISABLEOVERLAPPEDCONTENTDetermines重叠的内容是否启用或禁用。该pvParam参数必须指向一个BOOL变量，TRUE，如果能够得到，或否则返回FALSE。
显示功能，如背景图像，纹理背景，水商标的文件，alpha混合，可以减少和透明度之间的前景和背景的对比，便更难低视力的用户在屏幕上看到的对象。这个标志使您能够确定是否重叠的内容已被禁用。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_GETFILTERKEYSRetrieves信息的筛选辅助功能。该pvParam参数必须指向一个筛选的结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(筛选)。
SPI_GETFOCUSBORDERHEIGHTRetrieves的高度，以像素为单位与DrawFocusRect得出的焦点矩形的顶部和底部边缘。该pvParam参数必须指向一个UINT价值。
Windows 2000中：此参数是不支持。
SPI_GETFOCUSBORDERWIDTHRetrieves的宽度，以像素为单位与DrawFocusRect得出的焦点矩形的左，右边缘。该pvParam参数必须指向一个UINT。
Windows 2000中：此参数是不支持。
SPI_GETHIGHCONTRASTRetrieves信息的HighContrast辅助功能。该pvParam参数必须指向一个HIGHCONTRAST结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(HIGHCONTRAST)。
对于一般性的讨论，见备注。
SPI_GETMESSAGEDURATIONRetrieves该通知的弹出式窗口应显示时间，以秒。该pvParam参数必须指向一个乌龙接收邮件的时间。
有视觉障碍或诸如ADHD与阅读障碍的认知情况用户可能需要更长的时间来阅读文本的通知消息。这个标志使您可以检索信息的时间。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_GETMOUSECLICKLOCKRetrieves国家的鼠标单击锁定功能。该pvParam参数必须指向一个BOOL变量，TRUE，如果能够得到，或否则返回FALSE。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_GETMOUSECLICKLOCKTIMERetrieves前主鼠标按钮的时间延迟已被锁定。该pvParam参数必须指向为DWORD接收以毫秒为单位的时间延迟。这只是启用如果SPI_SETMOUSECLICKLOCK设置为TRUE。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_GETMOUSEKEYSRetrieves信息的鼠标键辅助功能。该pvParam参数必须指向一个鼠标键结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(鼠标键)。
SPI_GETMOUSESONARRetrieves国家的鼠标声纳功能。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果启用或否则返回FALSE。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_GETMOUSEVANISHRetrieves国家消失的鼠标功能。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果启用或否则返回FALSE。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_GETSCREENREADERDetermines屏幕审阅是否实用程序运行。阿屏幕审阅实用指示文字信息到一个输出设备，如语音合成器或点字显示器。当此标志设置，应用程序应提供文本信息的情况下，将目前的资料，否则图形。
该pvParam参数是一个BOOL变量，TRUE，如果收到一个屏幕评审实用程序运行，或指针，否则返回FALSE。
SPI_GETSERIALKEYSThis参数不支持。
Windows Server 2003和Windows XP/2000操作系统：用户应控制这一通过控制面板设置。
SPI_GETSHOWSOUNDSDetermines是否显示声音无障碍标志或关闭。如果它的用户需要提交的申请情况的资料，在视觉上的地方，否则目前，只有在听取形式的信息。该pvParam参数必须指向一个BOOL变量，TRUE，如果接收的功能，或假，如果是关闭的。
使用这个值相当于一遍遍SM_SHOWSOUNDS GetSystemMetrics。这是推荐的要求。
SPI_GETSOUNDSENTRYRetrieves信息的声音卫士辅助功能。该pvParam参数必须指向一个声音卫士结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(声音卫士)。
SPI_GETSTICKYKEYSRetrieves信息的粘滞键辅助功能。该pvParam参数必须指向一个粘滞键结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(粘滞键)。
SPI_GETTOGGLEKEYSRetrieves信息的切换键辅助功能。该pvParam参数必须指向一个切换键结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(切换键)。
SPI_SETACCESSTIMEOUTSets超时与辅助功能关联的时期。该pvParam参数必须指向一个ACCESSTIMEOUT结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(ACCESSTIMEOUT)。
SPI_SETAUDIODESCRIPTIONTurns音频描述或关闭功能。该pvParam参数是一个AUDIODESCRIPTION结构的指针。
虽然是为视障谁听到的音频视频内容，用户可能，有一个在视频不具有相应的音频很多交易行动。具体什么是发生在一个视频音频介绍帮助这些用户更好地了解的内容。这个标志可以让您启用或在他们所提供英寸语言禁用音频描述
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_SETCLIENTAREAANIMATIONTurns客户区动画或关闭。该pvParam参数是一个BOOL变量。设置为TRUE pvParam禁用动画和客户端区域，或FALSE其他短暂影响，并使他们。
显示功能，如闪光，闪烁，闪烁和移动的内容可能会导致与光敏用户癫痫发作。这个标志可以让您启用或禁用所有这些动画。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_SETDISABLEOVERLAPPEDCONTENTTurns重叠的内容(如背景图像和水印)或关闭。该pvParam参数是一个BOOL变量。设置为TRUE pvParam禁用重叠的内容，或FALSE，使重叠的内容。
显示功能，如背景图像，纹理背景，水商标的文件，alpha混合，可以减少和透明度之间的前景和背景的对比，便更难低视力的用户在屏幕上看到的对象。 This flag enables you to enable or disable all such overlapped content.
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_SETFILTERKEYSSets的筛选辅助功能的参数。该pvParam参数必须指向一个筛选结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(筛选)。
SPI_SETFOCUSBORDERHEIGHTSets的高度与DrawFocusRect提请的pvParam参数值焦点矩形的顶部和底部边缘。
Windows 2000中：此参数是不支持。
SPI_SETFOCUSBORDERWIDTHSets的高度与DrawFocusRect提请的pvParam参数值焦点矩形的左，右边缘。
Windows 2000中：此参数是不支持。
SPI_SETHIGHCONTRASTSets的HighContrast辅助功能的参数。该pvParam参数必须指向一个HIGHCONTRAST结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(HIGHCONTRAST)。
SPI_SETMESSAGEDURATIONSets该通知的弹出式窗口应显示时间，以秒。该pvParam参数必须指向一个乌龙，指定信息的时间。
有视觉障碍或诸如ADHD与阅读障碍的认知情况用户可能需要更长的时间来阅读文本的通知消息。这个标志使您可以设置邮件的时间。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_SETMOUSECLICKLOCKTurns鼠标单击锁定辅助功能或关闭。此功能暂时锁定主鼠标按钮的单击按钮，并承担因SPI_SETMOUSECLICKLOCKTIME指定的时间了。该参数指定为TRUE uiParam上，或关闭假。默认是关闭的。有关更多信息，请参见备注和关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_SETMOUSECLICKLOCKTIMEAdjusts前主鼠标按钮的时间延迟已被锁定。在uiParam参数应设置为0。在pvParam参数指向一个DWORD，指定以毫秒为单位的时间延迟。例如，指定为1秒钟的延迟1000。默认值为1200。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_SETMOUSEKEYSSets的鼠标键辅助功能的参数。该pvParam参数必须指向一个鼠标键结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(鼠标键)。
SPI_SETMOUSESONARTurns的声纳辅助功能或关闭。此功能简要说明指针周围有几个同心圆当用户按下并释放Ctrl键。 pvParam参数指定的就真和假的了。默认是关闭的。有关更多信息，请参阅关于鼠标输入。
Windows 2000中：此参数是不支持。
SPI_SETMOUSEVANISHTurns的消失或关闭功能。此功能隐藏鼠标指针当用户类型，指针重新出现时，用户移动鼠标。 pvParam参数指定的就真和假的了。默认是关闭的。有关更多信息，请参阅关于鼠标输入。
Windows 2000: This parameter is not supported.
SPI_SETSCREENREADERDetermines屏幕检讨是否实用程序运行。该参数指定为TRUE uiParam上，或关闭假。
SPI_SETSERIALKEYSThis参数不支持。
Windows Server 2003和Windows XP/2000操作系统：用户应控制这一通过控制面板设置。
SPI_SETSHOWSOUNDSTurns的声音显示辅助功能或关闭。 The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETSOUNDSENTRYSets的声音卫士辅助功能的参数。该pvParam参数必须指向一个声音卫士结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(声音卫士)。
SPI_SETSTICKYKEYSSets的粘滞键辅助功能的参数。该pvParam参数必须指向一个粘滞键结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(粘滞键)。
SPI_SETTOGGLEKEYSSets的切换键辅助功能的参数。该pvParam参数必须指向一个切换键结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(切换键)。
以下是在桌面上的参数。
桌面parameterMeaning
SPI_GETCLEARTYPEDetermines是否ClearType是启用。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果ClearType是启用，否则返回false。
ClearType是一种软件技术，提高了文本在液晶显示器(LCD)显示器的可读性。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_GETDESKWALLPAPERRetrieves的为桌面墙纸位图文件的完整路径。该pvParam参数必须指向一个缓冲区接收NULL结尾的路径字符串。设置uiParam参数的大小，以字符，在pvParam缓冲区。返回的字符串将不超过MAX_PATH字符。如果没有桌面墙纸，返回的字符串是空的。
SPI_GETDROPSHADOWDetermines是否阴影效果已启用。该pvParam参数必须指向一个BOOL变量，返回TRUE或FALSE启用如果禁用。
Windows 2000中：此参数是不支持。
SPI_GETFLATMENUDetermines本地用户菜单是否有单位菜单的外观。该pvParam参数必须指向一个BOOL变量，返回TRUE，如果单位菜单的外观设置，或否则返回FALSE。
Windows 2000中：此参数是不支持。
SPI_GETFONTSMOOTHINGDetermines是否字体平滑功能已启用。此功能使用字体抗锯齿字体，使曲线平滑，画像素出现在不同的灰度级。
该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果启用该功能，或FALSE如果不是。
SPI_GETFONTSMOOTHINGCONTRASTRetrieves的对比值在ClearType平滑使用。该pvParam参数必须指向一个UINT接收的信息。有效的对比度值1000至2200年。默认值为1400。
Windows 2000中：此参数是不支持。
SPI_GETFONTSMOOTHINGORIENTATIONRetrieves字体平滑方向。该pvParam参数必须指向一个UINT接收的信息。可能的值是FE_FONTSMOOTHINGORIENTATIONBGR(蓝绿色，红色)和FE_FONTSMOOTHINGORIENTATIONRGB(红，绿，蓝)。
Windows XP/2000操作系统：此参数是要到带有SP2的Windows XP的支持。
SPI_GETFONTSMOOTHINGTYPERetrieves平滑的字体类型。该pvParam参数必须指向一个UINT接收的信息。可能的值是FE_FONTSMOOTHINGSTANDARD和FE_FONTSMOOTHINGCLEARTYPE。
Windows 2000中：此参数是不支持。
SPI_GETWORKAREARetrieves工作的领域在主显示屏的大小。工作区域是在屏幕的部分不是由系统任务栏或桌面应用程序的工具栏模糊。该pvParam参数必须指向一个RECT结构，它接收的坐标的工作领域，虚拟屏幕坐标表示。
要获得一个监管与主显示屏其他工作领域，调用GetMonitorInfo功能。
SPI_SETCLEARTYPETurns或关闭ClearType。该pvParam参数是一个BOOL变量。设置pvParam为TRUE启用ClearType，或FALSE以禁用它。
ClearType是一种软件技术，提高了在液晶显示器文本的可读性。
Windows Server 2003和Windows XP/2000操作系统：此参数是不支持。
SPI_SETCURSORSReloads系统的游标。设置uiParam参数为零，pvParam参数为NULL。
通过使Windows读取模式=从WIN.INI文件设置SPI_SETDESKPATTERNSets当前的桌面模式。
SPI_SETDESKWALLPAPERSets的桌面墙纸。该pvParam参数值确定新的墙纸。要指定墙纸位图，设置pvParam指向一个NULL结尾的字符串包含完整路径图文件。设置pvParam为“”删除墙纸。设置pvParam的SETWALLPAPER_DEFAULT或NULL恢复为默认的墙纸。
该pvParam参数可以指定一个。jpg文件。
Windows Server 2003和Windows XP/2000操作系统：在pvParam参数不能指定。jpg文件。
SPI_SETDROPSHADOWEnables或禁用阴影效果。设置pvParam为TRUE，使阴影效果或FALSE以禁用它。您还必须CS_DROPSHADOW在窗口类的样式。
Windows 2000中：此参数是不支持。
SPI_SETFLATMENUEnables或禁用本地用户菜单单位菜单的外观。设置pvParam为TRUE，使单位菜单的外观或FALSE以禁用它。
启用后，使用菜单栏的菜单栏的背景COLOR_MENUBAR，为菜单COLOR_MENU，弹出的背景下，为填补目前的菜单选择，并为当前菜单选择纲要COLOR_HILIGHT COLOR_MENUHILIGHT。如果关闭，菜单绘制使用相同的颜色作为指标和Windows 2000中。
Windows 2000中：此参数是不支持。
SPI_SETFONTSMOOTHINGEnables或禁用字体平滑功能，它使用的字体，使字体抗锯齿曲线流畅，画像素出现在不同的灰度级。
启用该功能，设置uiParam参数设置为TRUE。要禁用此功能，设置uiParam为FALSE。
SPI_SETFONTSMOOTHINGCONTRASTSets对比度值ClearType平滑使用。该pvParam参数是对比度值。有效的对比度值1000至2200年。默认值为1400。
SPI_SETFONTSMOOTHINGTYPE也必须设置为FE_FONTSMOOTHINGCLEARTYPE。
Windows 2000中：此参数是不支持。
SPI_SETFONTSMOOTHINGORIENTATIONSets字体平滑方向。该pvParam参数是FE_FONTSMOOTHINGORIENTATIONBGR(蓝绿色，红色)或FE_FONTSMOOTHINGORIENTATIONRGB(红，绿，蓝)。
Windows XP/2000操作系统：此参数是要到带有SP2的Windows XP的支持。
SPI_SETFONTSMOOTHINGTYPESets平滑的字体类型。该pvParam参数是FE_FONTSMOOTHINGSTANDARD，如果标准抗锯齿使用，或FE_FONTSMOOTHINGCLEARTYPE，如果ClearType是使用。默认值为FE_FONTSMOOTHINGSTANDARD。
SPI_SETFONTSMOOTHING也必须设置。
Windows 2000中：此参数是不支持。
SPI_SETWORKAREASets工作的区域的大小。工作区域是在屏幕的部分不是由系统任务栏或桌面应用程序的工具栏模糊。该pvParam参数是一个RECT结构，指定新的工作领域的矩形，在虚拟屏幕坐标表示的指针。在一个多显示器系统，该函数设置的监视器包含指定的矩形工作区。
以下是该图标的参数。
图标parameterMeaning
SPI_GETICONMETRICSRetrieves与图标相关的指标。该pvParam参数必须指向一个ICONMETRICS结构，它接收的信息。设置这个结构cbSize成员和uiParam参数为sizeof(ICONMETRICS)。
SPI_GETICONTITLELOGFONTRetrieves的逻辑字体信息当前图标标题字体。在uiParam参数指定一个LOGFONT结构的大小，以及pvParam参数必须指向LOGFONT结构的填写
SPI_GETICONTITLEWRAPDetermines是否图标所有权包装启用。该pvParam参数必须指向一个BOOL变量，TRUE，如果能够得到，或否则返回FALSE。
SPI_ICONHORIZONTALSPACINGSets或撷取的宽度，以像素为一个图标细胞。该系统使用此矩形安排在大图标视图图标。
若要设置此值，设置uiParam为新值，并设置pvParam为NULL。您不能设置此值比SM_CXICON少。
要检索该值，pvParam必须指向一个整数，接收电流值。
SPI_ICONVERTICALSPACINGSets或撷取的高度，以像素为一个图标细胞。
若要设置此值，设置uiParam为新值，并设置pvParam为NULL。您不能设置此值比SM_CYICON少。
To retrieve this value, pvParam must point to an integer that receives the current value.
SPI_SETICONMETRICSSets与图标相关的指标。该pvParam参数必须指向一个ICONMETRICS结构，它包含了新的参数。设置这个结构cbSize成员和uiParam参数为sizeof(ICONMETRICS)。
SPI_SETICONSReloads的系统图标。设置uiParam参数为零，pvParam参数为NULL。
SPI_SETICONTITLELOGFONTSets的是用于图标标题的字体。在uiParam参数指定一个LOGFONT结构的大小，以及pvParam参数必须指向一个LOGFONT结构。
SPI_SETICONTITLEWRAPTurns图标标题包装或关闭。该参数指定为TRUE uiParam上，或关闭假。
以下是输入参数。它们包括与键盘，鼠标，输入语言参数，并警告蜂鸣器。
输入parameterMeaning
SPI_GETBEEPDetermines是否警告蜂鸣器上。
该pvParam参数必须指向一个BOOL变量，TRUE，如果收到的寻呼机上，或FALSE如果它是关闭的。
SPI_GETBLOCKSENDINPUTRESETSRetrieves一个BOOL指示是否可以重置一个应用程序通过调用SendInput函数的屏幕保护程序的定时器模拟键盘或鼠标输入。该pvParam参数必须指向一个BOOL变量，TRUE，如果接收模拟输入将被阻止，否则返回false。
SPI_GETDEFAULTINPUTLANGRetrieves输入系统的默认输入语言区域设置标识符。该pvParam参数必须指向一个 hkl 的变量接收这个值。有关更多信息，请参阅语言，区域设置和键盘布局。
SPI_GETKEYBOARDCUESDetermines菜单访问键是否总是强调。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果菜单访问键始终强调，假如果他们强调只有在菜单的键盘激活。
SPI_GETKEYBOARDDELAYRetrieves键盘重复延迟设置，这是一个范围从0(约250毫秒延迟到3(约1秒钟的延迟))的值。实际上延迟相关的每个值会因硬件。该pvParam参数必须指向一个整型变量，它接收设置。
SPI_GETKEYBOARDPREFDetermines用户是否上，而不是依靠鼠标键盘，并希望应用程序显示键盘，否则隐藏的接口。该pvParam参数必须指向一个BOOL变量，它接收TRUE，如果用户在键盘上依赖;或否则返回FALSE。
SPI_GETKEYBOARDSPEEDRetrieves键盘的重复速度设置，这是一个范围从0值(约2.5重复每秒31)(约每秒30重复)。实际的重复率是硬件依赖，并可能从线性比例相差高达20%。该pvParam参数必须指向一个DWORD变量，它接收设置。
SPI_GETMOUSERetrieves两个鼠标阈值和鼠标的加速度。该pvParam参数必须指向一个整数的三个接收这些值的数组。如需详细信息mouse_event。
SPI_GETMOUSEHOVERHEIGHTRetrieves的高度，以像素，该矩形内将鼠标指针已为TrackMouseEvent留生成WM_MOUSEHOVER消息。该pvParam参数必须指向一个UINT变量，它接收的高度。
SPI_GETMOUSEHOVERTIMERetrieves的时间，以毫秒为单位，即鼠标指针必须在矩形的TrackMouseEvent留悬停生成WM_MOUSEHOVER消息。该pvParam参数必须指向一个UINT变量，接收的时间。
SPI_GETMOUSEHOVERWIDTHRetrieves的宽度，以像素，该矩形内将鼠标指针已为TrackMouseEvent留生成WM_MOUSEHOVER消息。该pvParam参数必须指向一个UINT变量，它接收的宽度。
SPI_GETMOUSESPEEDRetrieves当前鼠标的速度。鼠标速度决定多远指针将进入距离为基础的鼠标移动。该pvParam参数必须指向一个整数，收到一个值，范围从1(最慢)及20(最快)。值10是默认的。该值可以设置一个最终用户使用鼠标控制面板应用程序或应用程序使用SPI_SETMOUSESPEED。
SPI_GETMOUSETRAILSDetermines是否鼠标滑道功能已启用。此功能提高了简要显示的游标线索，并迅速抹去他们的鼠标光标移动的知名度。
该pvParam参数必须指向一个整型变量接收一个值。如果该值为0或1，该功能被禁用。如果该值大于1，该功能被启用，并且值表示在特雷尔绘制游标数。该uiParam参数不使用。
Windows 2000中：此参数是不支持。
SPI_GETSNAPTODEFBUTTONDetermines是否对齐默认键功能已启用。如果启用，鼠标光标自动移动到默认的按钮，如确定或应用一个对话框，。该pvParam参数必须指向一个BOOL变量，TRUE，如果接收的功能，或假，如果是关闭的。
SPI_GETWHEELSCROLLCHARSRetrieves的字符数时，滚动鼠标滚轮的Level移动。该pvParam参数必须指向一个UINT变量，它接收的行数。默认值是3。
SPI_GETWHEELSCROLLLINESRetrieves行的数目时，滚动鼠标滚轮垂直移动。该pvParam参数必须指向一个UINT变量，它接收的行数。默认值是3。
SPI_SETBEEPTurns警告蜂鸣器或关闭。 The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETBLOCKSENDINPUTRESETSDetermines申请是否可以重置通过调用SendInput函数的屏幕保护程序的定时器模拟键盘或鼠标输入。在uiParam参数指定TRUE，如果屏幕保护程序不会被模拟的输入，或FALSE停用屏幕保护程序，如果将模拟输入停用。
SPI_SETDEFAULTINPUTLANGSets的默认系统外壳和应用程序输入语言。指定要显示的语言，使用当前系统字符集。该pvParam参数必须指向一个 hkl 变量包含的默认语言输入法区域设置标识符。有关更多信息，请参阅语言，区域设置和键盘布局。
SPI_SETDOUBLECLICKTIMESets的双对向uiParam参数值的鼠标点击时间。在双击时间是毫秒之间可能出现一个双击第一和第二最高点击次数。您还可以调用SetDoubleClickTime函数来设置双击时间。获取当前双击时间，调用GetDoubleClickTime功能。
SPI_SETDOUBLECLKHEIGHTSets的高度，双击矩形的uiParam参数的值。
在双击矩形是矩形内的一双击必须属于它作为一双击注册的第二次点击。
要检索的双击矩形的高度，与SM_CYDOUBLECLK标志调用GetSystemMetrics。
SPI_SETDOUBLECLKWIDTHSets的宽度双击矩形的uiParam参数的值。
在双击矩形是矩形内的一双击必须属于它作为一双击注册的第二次点击。
要检索的双击矩形的宽度，与SM_CXDOUBLECLK标志调用GetSystemMetrics。
SPI_SETKEYBOARDCUESSets的菜单访问键字母标明。该pvParam参数是一个BOOL变量。设置为TRUE pvParam始终强调菜单访问键，或FALSE强调菜单进入菜单时，才从键盘激活键。
SPI_SETKEYBOARDDELAYSets键盘重复延迟设置。该uiParam参数必须指定0，1，2或3，其中最短的零延迟设置大约250毫秒)和3台最长的延迟(大约1秒)。实际上延迟相关的每个值会因硬件。
SPI_SETKEYBOARDPREFSets键盘偏好。在uiParam参数指定TRUE，如果用户上，而不是依靠鼠标键盘，并希望应用程序显示键盘，否则隐藏的接口; uiParam是否则返回FALSE。
SPI_SETKEYBOARDSPEEDSets键盘的重复速度设定。该uiParam参数必须指定从0范围内的值为31秒(约2.5重复)(每秒约30重复)。实际的重复率是硬件依赖，并可能从线性比例相差高达20%。如果uiParam大于31，参数设置为31。
SPI_SETLANGTOGGLESets热键输入语言之间的转换设置。在uiParam和pvParam参数不使用。设置该值通过读取注册表再次在键盘属性页的快捷键。注册表之前，必须设置此标志使用。注册表中的路径
HKEY_CURRENT_USER \\键盘布局\\切换
。有效值为“1”= Alt + Shift键，“2”=按CTRL + SHIFT键，“3”=无。
SPI_SETMOUSESets两个鼠标阈值和鼠标的加速度。该pvParam参数必须指向三个整数，指定这些值的数组。如需详细信息mouse_event。
SPI_SETMOUSEBUTTONSWAPSwaps或恢复的左，右鼠标按钮的含义。在uiParam参数指定为TRUE交换的按钮，或FALSE的含义，以恢复其原来的意义。
要检索当前的设置与SM_SWAPBUTTON国旗，呼吁GetSystemMetrics。
SPI_SETMOUSEHOVERHEIGHTSets the height, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParam parameter to the new height.
SPI_SETMOUSEHOVERTIMESets the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle for TrackMouseEvent to generate a WM_MOUSEHOVER message. This is used only if you pass HOVER_DEFAULT in the dwHoverTime parameter in the call to TrackMouseEvent. Set the uiParamparameter to the new time.
The time specified should be between USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM. If uiParam is less than USER_TIMER_MINIMUM, the function will use USER_TIMER_MINIMUM. If uiParam is greater than USER_TIMER_MAXIMUM, the function will be USER_TIMER_MAXIMUM.
Windows Server 2003 and Windows XP: The operating system does not enforce the use of USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM until Windows Server 2003 with SP1 and Windows XP with SP2.
SPI_SETMOUSEHOVERWIDTHSets the width, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParam parameter to the new width.
SPI_SETMOUSESPEEDSets the current mouse speed. The pvParam parameter is an integer between 1 (slowest) and 20 (fastest). A value of 10 is the default. This value is typically set using the mouse control panel application.
SPI_SETMOUSETRAILSEnables or disables the Mouse Trails feature, which improves the visibility of mouse cursor movements by briefly showing a trail of cursors and quickly erasing them.
To disable the feature, set the uiParam parameter to zero or 1. To enable the feature, set uiParam to a value greater than 1 to indicate the number of cursors drawn in the trail.
Windows 2000: This parameter is not supported.
SPI_SETSNAPTODEFBUTTONEnables or disables the snap-to-default-button feature. If enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box. Set the uiParam parameter to TRUE to enable the feature, or FALSE to disable it. Applications should use the ShowWindow function when displaying a dialog box so the dialog manager can position the mouse cursor.
SPI_SETWHEELSCROLLCHARSSets the number of characters to scroll when the horizontal mouse wheel is moved. The number of characters is set from the uiParam parameter.
SPI_SETWHEELSCROLLLINESSets the number of lines to scroll when the vertical mouse wheel is moved. The number of lines is set from the uiParam parameter.
The number of lines is the suggested number of lines to scroll when the mouse wheel is rolled without using modifier keys. If the number is 0, then no scrolling should occur. If the number of lines to scroll is greater than the number of lines viewable, and in particular if it is WHEEL_PAGESCROLL (#defined as UINT_MAX), the scroll operation should be interpreted as clicking once in the page down or page up regions of the scroll bar.
The following are the menu parameters.
Menu parameterMeaning
SPI_GETMENUDROPALIGNMENTDetermines whether pop-up menus are left-aligned or right-aligned, relative to the corresponding menu-bar item. The pvParam parameter must point to a BOOL variable that receives TRUE if right-aligned, or FALSE otherwise.
SPI_GETMENUFADEDetermines whether menu fade animation is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE when fade animation is enabled and FALSE when it isdisabled. If fade animation is disabled, menus use slide animation. This flag is ignored unless menu animation is enabled, which you can do using the SPI_SETMENUANIMATION flag. For more information, see AnimateWindow .
SPI_GETMENUSHOWDELAYRetrieves the time, in milliseconds, that the system waits before displaying a shortcut menu when the mouse cursor is over a submenu item. The pvParam parameter must point to a DWORD variable that receives the time of the delay.
SPI_SETMENUDROPALIGNMENTSets the alignment value of pop-up menus. The uiParam parameter specifies TRUE for right alignment, or FALSE for left alignment.
SPI_SETMENUFADEEnables or disables menu fade animation. Set pvParam to TRUE to enable the menu fade effect or FALSE to disable it. If fade animation is disabled, menus use slide animation. he The menu fade effect is possible only if the system has a color depth of more than 256 colors. This flag is ignored unless SPI_MENUANIMATION is also set. For more information, see AnimateWindow .
SPI_SETMENUSHOWDELAYSets uiParam to the time, in milliseconds, that the system waits before displaying a shortcut menu when the mouse cursor is over a submenu item.
The following are the power parameters.
Beginning with Windows Server 2008 and Windows Vista, these power parameters are not supported. Instead, to determine the current display power state, an application should register for GUID_MONITOR_POWER_STATE notifications. To determine the current display power down time-out, an application should register for notification of changes to the GUID_VIDEO_POWERDOWN_TIMEOUT power setting. For more information, see Registering for Power Events .
Windows Server 2003 and Windows XP/2000: To determine the current display power state, use the following power parameters.
Power parameterMeaning
SPI_GETLOWPOWERACTIVEThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Determines whether the low-power phase of screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE if disabled. This flag is supported for 32-bit applications only.
SPI_GETLOWPOWERTIMEOUTThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Retrieves the time-out value for the low-power phase of screen saving. The pvParam parameter must point to an integer variable that receives the value. This flag is supported for 32-bit applications only.
SPI_GETPOWEROFFACTIVEThis parameter is not supported. When the power-off phase of screen saving is enabled, the GUID_VIDEO_POWERDOWN_TIMEOUT power setting is greater than zero.
Windows Server 2003 and Windows XP/2000: Determines whether the power-off phase of screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE if disabled. This flag is supported for 32-bit applications only.
SPI_GETPOWEROFFTIMEOUTThis parameter is not supported. Instead, check the GUID_VIDEO_POWERDOWN_TIMEOUT power setting.
Windows Server 2003 and Windows XP/2000: Retrieves the time-out value for the power-off phase of screen saving. The pvParam parameter must point to an integer variable that receives the value. This flag is supported for 32-bit applications only.
SPI_SETLOWPOWERACTIVEThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Activates or deactivates the low-power phase of screen saving. Set uiParam to 1 to activate, or zero to deactivate. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETLOWPOWERTIMEOUTThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Sets the time-out value, in seconds, for the low-power phase of screen saving. The uiParam parameter specifies the new value. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETPOWEROFFACTIVEThis parameter is not supported. Instead, set the GUID_VIDEO_POWERDOWN_TIMEOUT power setting.
Windows Server 2003 and Windows XP/2000: Activates or deactivates the power-off phase of screen saving. Set uiParam to 1 to activate, or zero to deactivate. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETPOWEROFFTIMEOUTThis parameter is not supported. Instead, set the GUID_VIDEO_POWERDOWN_TIMEOUT power setting to a time-out value.
Windows Server 2003 and Windows XP/2000: Sets the time-out value, in seconds, for the power-off phase of screen saving. The uiParam parameter specifies the new value. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
The following are the screen saver parameters.
Screen saver parameterMeaning
SPI_GETSCREENSAVEACTIVEDetermines whether screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if screen saving is enabled, or FALSE otherwise.
Windows 7, Windows Server 2008 R2, and Windows 2000: The function returns TRUE even when screen saving is not enabled. For more information and a workaround, see KB318781 .
SPI_GETSCREENSAVERRUNNINGDetermines whether a screen saver is currently running on the window station of the calling process. The pvParam parameter must point to a BOOL variable that receives TRUE if a screen saver is currently running, or FALSE otherwise. Note that only the interactive window station, WinSta0, can have a screen saver running.
SPI_GETSCREENSAVESECUREDetermines whether the screen saver requires a password to display the Windows desktop. The pvParam parameter must point to a BOOL variable that receives TRUE if the screen saver requires a password, or FALSE otherwise. The uiParam parameter is ignored.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETSCREENSAVETIMEOUTRetrieves the screen saver time-out value, in seconds. The pvParam parameter must point to an integer variable that receives the value.
SPI_SETSCREENSAVEACTIVESets the state of the screen saver. The uiParam parameter specifies TRUE to activate screen saving, or FALSE to deactivate it.
SPI_SETSCREENSAVESECURESets whether the screen saver requires the user to enter a password to display the Windows desktop. The uiParam parameter is a BOOL variable. The pvParam parameter is ignored. Set uiParam to TRUE to require a password, or FALSE to not require a password.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETSCREENSAVETIMEOUTSets the screen saver time-out value to the value of the uiParam parameter. This value is the amount of time, in seconds, that the system must be idle before the screen saver activates.
The following are the time-out parameters for applications and services.
Time-out parameterMeaning
SPI_GETHUNGAPPTIMEOUTRetrieves the number of milliseconds that a thread can go without dispatching a message before the system considers it unresponsive. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWAITTOKILLTIMEOUTRetrieves the number of milliseconds that the system waits before terminating an application that does not respond to a shutdown request. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWAITTOKILLSERVICETIMEOUTRetrieves the number of milliseconds that the service control manager waits before terminating a service that does not respond to a shutdown request. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETHUNGAPPTIMEOUTSets the hung application time-out to the value of the uiParam parameter. This value is the number of milliseconds that a thread can go without dispatching a message before the system considers it unresponsive.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWAITTOKILLTIMEOUTSets the application shutdown request time-out to the value of the uiParam parameter. This value is the number of milliseconds that the system waits before terminating an application that does not respond to a shutdown request.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWAITTOKILLSERVICETIMEOUTSets the service shutdown request time-out to the value of the uiParam parameter. This value is the number of milliseconds that the system waits before terminating a service that does not respond to a shutdown request.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
The following are the UI effects. The SPI_SETUIEFFECTS value is used to enable or disable all UI effects at once. This table contains the complete list of UI effect values.
UI effects parameterMeaning
SPI_GETCOMBOBOXANIMATIONDetermines whether the slide-open effect for combo boxes is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
SPI_GETCURSORSHADOWDetermines whether the cursor has a shadow around it. The pvParam parameter must point to a BOOL variable that receives TRUE if the shadow is enabled, FALSE if it is disabled. This effect appears only if the system has a color depth of more than 256 colors.
SPI_GETGRADIENTCAPTIONSDetermines whether the gradient effect for window title bars is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled. For more information about the gradient effect, see the GetSysColor function.
SPI_GETHOTTRACKINGDetermines whether hot tracking of user-interface elements, such as menu names on menu bars, is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
热点追踪意味着，当对一个项目的光标移动，它突出了，但未被选中。 You can query this value to decide whether to use hot tracking in the user interface of your application.
SPI_GETLISTBOXSMOOTHSCROLLINGDetermines whether the smooth-scrolling effect for list boxes is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
SPI_GETMENUANIMATIONDetermines whether the menu animation feature is enabled. This master switch must be on to enable menu animation effects. The pvParam parameter must point to a BOOL variable that receives TRUE if animation is enabled and FALSE if it is disabled.
If animation is enabled, SPI_GETMENUFADE indicates whether menus use fade or slide animation.
SPI_GETMENUUNDERLINESSame as SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADEDetermines whether the selection fade effect is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE if disabled.
The selection fade effect causes the menu item selected by the user to remain on the screen briefly while fading out after the menu is dismissed.
SPI_GETTOOLTIPANIMATIONDetermines whether ToolTip animation is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE if disabled. If ToolTip animation is enabled, SPI_GETTOOLTIPFADE indicates whether ToolTips use fade or slide animation.
SPI_GETTOOLTIPFADEIf SPI_SETTOOLTIPANIMATION is enabled, SPI_GETTOOLTIPFADE indicates whether ToolTip animation uses a fade effect or a slide effect. The pvParam parameter must point to a BOOL variable that receives TRUE for fade animation or FALSE for slide animation. For more information on slide and fade effects, see AnimateWindow .
SPI_GETUIEFFECTSDetermines whether UI effects are enabled or disabled. The pvParam parameter must point to a BOOL variable that receives TRUE if all UI effects are enabled, or FALSE if they are disabled.
SPI_SETCOMBOBOXANIMATIONEnables or disables the slide-open effect for combo boxes. Set the pvParam parameter to TRUE to enable the gradient effect, or FALSE to disable it.
SPI_SETCURSORSHADOWEnables or disables a shadow around the cursor. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to enable the shadow or FALSE to disable the shadow. This effect appears only if the system has a color depth of more than 256 colors.
SPI_SETGRADIENTCAPTIONSEnables or disables the gradient effect for window title bars. Set the pvParam parameter to TRUE to enable it, or FALSE to disable it. The gradient effect is possible only if the system has a color depth of more than 256 colors. For more information about the gradient effect, see the GetSysColor function.
SPI_SETHOTTRACKINGEnables or disables hot tracking of user-interface elements such as menu names on menu bars. Set the pvParam parameter to TRUE to enable it, or FALSE to disable it.
Hot-tracking means that when the cursor moves over an item, it is highlighted but not selected.
SPI_SETLISTBOXSMOOTHSCROLLINGEnables or disables the smooth-scrolling effect for list boxes. Set the pvParam parameter to TRUE to enable the smooth-scrolling effect, or FALSE to disable it.
SPI_SETMENUANIMATIONEnables or disables menu animation. This master switch must be on for any menu animation to occur. The pvParam parameter is a BOOL variable; set pvParam to TRUE to enable animation and FALSE to disable animation.
If animation is enabled, SPI_GETMENUFADE indicates whether menus use fade or slide animation.
SPI_SETMENUUNDERLINESSame as SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADESet pvParam to TRUE to enable the selection fade effect or FALSE to disable it.
The selection fade effect causes the menu item selected by the user to remain on the screen briefly while fading out after the menu is dismissed. The selection fade effect is possible only if the system has a color depth of more than 256 colors.
SPI_SETTOOLTIPANIMATIONSet pvParam to TRUE to enable ToolTip animation or FALSE to disable it. If enabled, you can use SPI_SETTOOLTIPFADE to specify fade or slide animation.
SPI_SETTOOLTIPFADEIf the SPI_SETTOOLTIPANIMATION flag is enabled, use SPI_SETTOOLTIPFADE to indicate whether ToolTip animation uses a fade effect or a slide effect. Set pvParam to TRUE for fade animation or FALSE for slide animation. The tooltip fade effect is possible only if the system has a color depth of more than 256 colors. For more information on the slide and fade effects, see the AnimateWindow function.
SPI_SETUIEFFECTSEnables or disables UI effects. Set the pvParam parameter to TRUE to enable all UI effects or FALSE to disable all UI effects.
The following are the window parameters.
Window parameterMeaning
SPI_GETACTIVEWINDOWTRACKINGDetermines whether active window tracking (activating the window the mouse is on) is on or off. The pvParam parameter must point to a BOOL variable that receives TRUE for on, or FALSE for off.
SPI_GETACTIVEWNDTRKZORDERDetermines whether windows activated through active window tracking will be brought to the top. The pvParam parameter must point to a BOOL variable that receives TRUE for on, or FALSE for off.
SPI_GETACTIVEWNDTRKTIMEOUTRetrieves the active window tracking delay, in milliseconds. The pvParam parameter must point to a DWORD variable that receives the time.
SPI_GETANIMATIONRetrieves the animation effects associated with user actions. The pvParam parameter must point to an ANIMATIONINFO structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(ANIMATIONINFO).
SPI_GETBORDERRetrieves the border multiplier factor that determines the width of a window's sizing border. The pvParam parameter must point to an integer variable that receives this value.
SPI_GETCARETWIDTHRetrieves the caret width in edit controls, in pixels. The pvParam parameter must point to a DWORD variable that receives this value.
SPI_GETDOCKMOVINGDetermines whether a window is docked when it is moved to the top, left, or right edges of a monitor or monitor array. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETDRAGFROMMAXIMIZEDetermines whether a maximized window is restored when its caption bar is dragged. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETDRAGFULLWINDOWSDetermines whether dragging of full windows is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
SPI_GETFOREGROUNDFLASHCOUNTRetrieves the number of times SetForegroundWindow will flash the taskbar button when rejecting a foreground switch request. The pvParam parameter must point to a DWORD variable that receives the value.
SPI_GETFOREGROUNDLOCKTIMEOUTRetrieves the amount of time following user input, in milliseconds, during which the system will not allow applications to force themselves into the foreground. The pvParam parameter must point to a DWORD variable that receives the time.
SPI_GETMINIMIZEDMETRICSRetrieves the metrics associated with minimized windows. The pvParam parameter must point to a MINIMIZEDMETRICS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLDRetrieves the threshold in pixels where docking behavior is triggered by using a mouse to drag a window to the edge of a monitor or monitor array. The default threshold is 1. The pvParam parameter must point to a DWORD variable that receives the value.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETMOUSEDRAGOUTTHRESHOLDRetrieves the threshold in pixels where undocking behavior is triggered by using a mouse to drag a window from the edge of a monitor or a monitor array toward the center. The default threshold is 20.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETMOUSESIDEMOVETHRESHOLDRetrieves the threshold in pixels from the top of a monitor or a monitor array where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETNONCLIENTMETRICSRetrieves the metrics associated with the nonclient area of nonminimized windows. The pvParam parameter must point to a NONCLIENTMETRICS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(NONCLIENTMETRICS).
SPI_GETPENDOCKTHRESHOLDRetrieves the threshold in pixels where docking behavior is triggered by using a pen to drag a window to the edge of a monitor or monitor array. The default is 30.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETPENDRAGOUTTHRESHOLDRetrieves the threshold in pixels where undocking behavior is triggered by using a pen to drag a window from the edge of a monitor or monitor array toward its center. The default threshold is 30.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETPENSIDEMOVETHRESHOLDRetrieves the threshold in pixels from the top of a monitor or monitor array where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETSHOWIMEUIDetermines whether the IME status window is visible (on a per-user basis). The pvParam parameter must point to a BOOL variable that receives TRUE if the status window is visible, or FALSE if it is not.
SPI_GETSNAPSIZINGDetermines whether a window is vertically maximized when it is sized to the top or bottom of a monitor or monitor array. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWINARRANGINGDetermines whether window arrangement is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Window arrangement reduces the number of mouse, pen, or touch interactions needed to move and size top-level windows by simplifying the default behavior of a window when it is dragged or sized.
The following parameters retrieve individual window arrangement settings:
SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETACTIVEWINDOWTRACKINGSets active window tracking (activating the window the mouse is on) either on or off. Set pvParam to TRUE for on or FALSE for off.
SPI_SETACTIVEWNDTRKZORDERDetermines whether or not windows activated through active window tracking should be brought to the top. Set pvParam to TRUE for on or FALSE for off.
SPI_SETACTIVEWNDTRKTIMEOUTSets the active window tracking delay. Set pvParam to the number of milliseconds to delay before activating the window under the mouse pointer.
SPI_SETANIMATIONSets the animation effects associated with user actions. The pvParam parameter must point to an ANIMATIONINFO structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(ANIMATIONINFO).
SPI_SETBORDERSets the border multiplier factor that determines the width of a window's sizing border. The uiParam parameter specifies the new value.
SPI_SETCARETWIDTHSets the caret width in edit controls. Set pvParam to the desired width, in pixels. The default and minimum value is 1.
SPI_SETDOCKMOVINGSets whether a window is docked when it is moved to the top, left, or right docking targets on a monitor or monitor array. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETDRAGFROMMAXIMIZESets whether a maximized window is restored when its caption bar is dragged. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETDRAGFULLWINDOWSSets dragging of full windows either on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETDRAGHEIGHTSets the height, in pixels, of the rectangle used to detect the start of a drag operation. Set uiParam to the new value. To retrieve the drag height, call GetSystemMetrics with the SM_CYDRAG flag.
SPI_SETDRAGWIDTHSets the width, in pixels, of the rectangle used to detect the start of a drag operation. Set uiParam to the new value. To retrieve the drag width, call GetSystemMetrics with the SM_CXDRAG flag.
SPI_SETFOREGROUNDFLASHCOUNTSets the number of times SetForegroundWindow will flash the taskbar button when rejecting a foreground switch request. Set pvParam to the number of times to flash.
SPI_SETFOREGROUNDLOCKTIMEOUTSets the amount of time following user input, in milliseconds, during which the system does not allow applications to force themselves into the foreground. Set pvParam to the new time-out value.
The calling thread must be able to change the foreground window, otherwise the call fails.
SPI_SETMINIMIZEDMETRICSSets the metrics associated with minimized windows. The pvParam parameter must point to a MINIMIZEDMETRICS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLDSets the threshold in pixels where docking behavior is triggered by using a mouse to drag a window to the edge of a monitor or monitor array. The default threshold is 1. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETMOUSEDRAGOUTTHRESHOLDSets the threshold in pixels where undocking behavior is triggered by using a mouse to drag a window from the edge of a monitor or monitor array to its center. The default threshold is 20. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETMOUSESIDEMOVETHRESHOLDSets the threshold in pixels from the top of the monitor where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETNONCLIENTMETRICSSets the metrics associated with the nonclient area of nonminimized windows. The pvParam parameter must point to a NONCLIENTMETRICS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(NONCLIENTMETRICS). Also, the lfHeight member of the LOGFONT structure must be a negative value.
SPI_SETPENDOCKTHRESHOLDSets the threshold in pixels where docking behavior is triggered by using a pen to drag a window to the edge of a monitor or monitor array. The default threshold is 30. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETPENDRAGOUTTHRESHOLDSets the threshold in pixels where undocking behavior is triggered by using a pen to drag a window from the edge of a monitor or monitor array to its center. The default threshold is 30. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETPENSIDEMOVETHRESHOLDSets the threshold in pixels from the top of the monitor where a vertically maximized window is restored when dragged with a pen. The default threshold is 50. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETSHOWIMEUISets whether the IME status window is visible or not on a per-user basis. The uiParam parameter specifies TRUE for on or FALSE for off.
SPI_SETSNAPSIZINGSets whether a window is vertically maximized when it is sized to the top or bottom of the monitor. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWINARRANGINGSets whether window arrangement is enabled. Set pvParam to TRUE for on or FALSE for off.
Window arrangement reduces the number of mouse, pen, or touch interactions needed to move and size top-level windows by simplifying the default behavior of a window when it is dragged or sized.
The following parameters set individual window arrangement settings:
SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
uiParam [in]
A parameter whose usage and format depends on the system parameter being queried or set. For more information about system-wide parameters, see the uiAction parameter. If not otherwise indicated, you must specify zero for this parameter.
pvParam [in, out]
A parameter whose usage and format depends on the system parameter being queried or set. For more information about system-wide parameters, see the uiAction parameter. If not otherwise indicated, you must specify NULL for this parameter.
fWinIni [in]
If a system parameter is being set, specifies whether the user profile is to be updated, and if so, whether the WM_SETTINGCHANGE message is to be broadcast to all top-level windows to notify them of the change.
This parameter can be zero if you don't want to update the user profile or broadcast the WM_SETTINGCHANGE message, or it can be one or more of the following values.
ValueMeaning
SPIF_UPDATEINIFILEWrites the new system-wide parameter setting to the user profile.
SPIF_SENDCHANGEBroadcasts the WM_SETTINGCHANGE message after updating the user profile.
SPIF_SENDWININICHANGESame as SPIF_SENDCHANGE.
返回值
如果函数成功，返回值是一个非零值。
如果函数失败，返回值是零。为了获得更多错误信息，调用GetLastError。
备注
This function is intended for use with applications that allow the user to customize the environment.
A keyboard layout name should be derived from the hexadecimal value of the language identifier corresponding to the layout.例如，美国英语的0x0409语言标识符，因此主美国英语的布局被命名为“00000409”。 Variants of U.S. English layout, such as the Dvorak layout, are named "00010409", "00020409" and so on. For a list of the primary language identifiers and sublanguage identifiers that make up a language identifier, see the MAKELANGID macro.
There is a difference between the High Contrast color scheme and the High Contrast Mode. The High Contrast color scheme changes the system colors to colors that have obvious contrast; you switch to this color scheme by using the Display Options in the control panel. The High Contrast Mode, which uses SPI_GETHIGHCONTRAST and SPI_SETHIGHCONTRAST, advises applications to modify their appearance for visually-impaired users. It involves such things as audible warning to users and customized color scheme (using the Accessibility Options in the control panel). For more information, see HIGHCONTRAST . For more information on general accessibility features, see Accessibility .
During the time that the primary button is held down to activate the Mouse ClickLock feature, the user can move the mouse. Once the primary button is locked down, releasing the primary button does not result in a WM_LBUTTONUP message. Thus, it will appear to an application that the primary button is still down. Any subsequent button message releases the primary button, sending a WM_LBUTTONUP message to the application, thus the button can be unlocked programmatically or through the user clicking any button.
实例
有关示例，请参见获取硬件信息。
要求：
最低支持：client－Windows 2000专业版
最低支持server－Windows 2000服务器
HeaderWinuser.h(头文件：winuser.h)
LibraryUser32.lib
DLLUser32.dll
Unicode and ANSI namesSystemParametersInfoW (Unicode) and SystemParametersInfoA (ANSI)
参见
ACCESSTIMEOUT
ANIMATIONINFO
AUDIODESCRIPTION
FILTERKEYS
HIGHCONTRAST
ICONMETRICS
逻辑字体
MAKELANGID
MINIMIZEDMETRICS
MOUSEKEYS
NONCLIENTMETRICS
RECT
SERIALKEYS
SOUNDSENTRY
STICKYKEYS
TOGGLEKEYS
WM_SETTINGCHANGE消息
如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com)
生成日期：2009年8月27日
＝＝英文原文＝＝SystemParametersInfo Function
Retrieves or sets the value of one of the system-wide parameters. This function can also update the user profile while setting a parameter.
Syntax
C++
BOOL WINAPI SystemParametersInfo(
__in UINT uiAction,
__in UINT uiParam,
__inout PVOID pvParam,
__in UINT fWinIni
);
Parameters
uiAction [in]
The system-wide parameter to be retrieved or set. The possible values are organized in the following tables of related parameters:
Accessibility parameters
Desktop parameters
Icon parameters
Input parameters
Menu parameters
Power parameters
Screen saver parameters
Time-out parameters
UI effect parameters
Window parameters
The following are the accessibility parameters.
Accessibility parameterMeaning
SPI_GETACCESSTIMEOUTRetrieves information about the time-out period associated with the accessibility features. The pvParam parameter must point to an ACCESSTIMEOUT structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTIONDetermines whether audio descriptions are enabled or disabled. The pvParam parameter is a pointer to an AUDIODESCRIPTION structure. Set the cbSize member of this structure and the uiParam parameter to sizeof(AUDIODESCRIPTION).
While it is possible for users who have visual impairments to hear the audio in video content, there is a lot of action in video that does not have corresponding audio. Specific audio description of what is happening in a video helps these users understand the content better. This flag enables you to determine whether audio descriptions have been enabled and in which language.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETCLIENTAREAANIMATIONDetermines whether animations are enabled or disabled. The pvParam parameter must point to a BOOL variable that receives TRUE if animations are disabled, or FALSE otherwise.
Display features such as flashing, blinking, flickering, and moving content can cause seizures in users with photo-sensitive epilepsy. This flag enables you to determine whether such animations have been disabled in the client area.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETDISABLEOVERLAPPEDCONTENTDetermines whether overlapped content is enabled or disabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Display features such as background images, textured backgrounds, water marks on documents, alpha-blending, and transparency can reduce the contrast between the foreground and background, making it harder for users with low vision to see objects on the screen. This flag enables you to determine whether such overlapped content has been disabled.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETFILTERKEYSRetrieves information about the FilterKeys accessibility feature. The pvParam parameter must point to a FILTERKEYS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHTRetrieves the height, in pixels, of the top and bottom edges of the focus rectangle drawn with DrawFocusRect . The pvParam parameter must point to a UINT value.
Windows 2000: This parameter is not supported.
SPI_GETFOCUSBORDERWIDTHRetrieves the width, in pixels, of the left and right edges of the focus rectangle drawn with DrawFocusRect . The pvParam parameter must point to a UINT.
Windows 2000: This parameter is not supported.
SPI_GETHIGHCONTRASTRetrieves information about the HighContrast accessibility feature. The pvParam parameter must point to a HIGHCONTRAST structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(HIGHCONTRAST).
For a general discussion, see Remarks.
SPI_GETMESSAGEDURATIONRetrieves the time that notification pop-ups should be displayed, in seconds. The pvParam parameter must point to a ULONG that receives the message duration.
Users with visual impairments or cognitive conditions such as ADHD and dyslexia might need a longer time to read the text in notification messages. This flag enables you to retrieve the message duration.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETMOUSECLICKLOCKRetrieves the state of the Mouse ClickLock feature. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_GETMOUSECLICKLOCKTIMERetrieves the time delay before the primary mouse button is locked. The pvParam parameter must point to DWORD that receives the time delay, in milliseconds. This is only enabled if SPI_SETMOUSECLICKLOCK is set to TRUE. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_GETMOUSEKEYSRetrieves information about the MouseKeys accessibility feature. The pvParam parameter must point to a MOUSEKEYS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(MOUSEKEYS).
SPI_GETMOUSESONARRetrieves the state of the Mouse Sonar feature. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE otherwise. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_GETMOUSEVANISHRetrieves the state of the Mouse Vanish feature. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE otherwise. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_GETSCREENREADERDetermines whether a screen reviewer utility is running. A screen reviewer utility directs textual information to an output device, such as a speech synthesizer or Braille display. When this flag is set, an application should provide textual information in situations where it would otherwise present the information graphically.
The pvParam parameter is a pointer to a BOOL variable that receives TRUE if a screen reviewer utility is running, or FALSE otherwise.
SPI_GETSERIALKEYSThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: The user should control this setting through the Control Panel.
SPI_GETSHOWSOUNDSDetermines whether the Show Sounds accessibility flag is on or off. If it is on, the user requires an application to present information visually in situations where it would otherwise present the information only in audible form. The pvParam parameter must point to a BOOL variable that receives TRUE if the feature is on, or FALSE if it is off.
Using this value is equivalent to calling GetSystemMetrics with SM_SHOWSOUNDS. That is the recommended call.
SPI_GETSOUNDSENTRYRetrieves information about the SoundSentry accessibility feature. The pvParam parameter must point to a SOUNDSENTRY structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYSRetrieves information about the StickyKeys accessibility feature. The pvParam parameter must point to a STICKYKEYS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYSRetrieves information about the ToggleKeys accessibility feature. The pvParam parameter must point to a TOGGLEKEYS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUTSets the time-out period associated with the accessibility features. The pvParam parameter must point to an ACCESSTIMEOUT structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTIONTurns the audio descriptions feature on or off. The pvParam parameter is a pointer to an AUDIODESCRIPTION structure.
While it is possible for users who are visually impaired to hear the audio in video content, there is a lot of action in video that does not have corresponding audio. Specific audio description of what is happening in a video helps these users understand the content better. This flag enables you to enable or disable audio descriptions in the languages they are provided in.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETCLIENTAREAANIMATIONTurns client area animations on or off. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to disable animations and other transient effects in the client area, or FALSE to enable them.
Display features such as flashing, blinking, flickering, and moving content can cause seizures in users with photo-sensitive epilepsy. This flag enables you to enable or disable all such animations.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETDISABLEOVERLAPPEDCONTENTTurns overlapped content (such as background images and watermarks) on or off. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to disable overlapped content, or FALSE to enable overlapped content.
Display features such as background images, textured backgrounds, water marks on documents, alpha-blending, and transparency can reduce the contrast between the foreground and background, making it harder for users with low vision to see objects on the screen. This flag enables you to enable or disable all such overlapped content.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETFILTERKEYSSets the parameters of the FilterKeys accessibility feature. The pvParam parameter must point to a FILTERKEYS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHTSets the height of the top and bottom edges of the focus rectangle drawn with DrawFocusRect to the value of the pvParam parameter.
Windows 2000: This parameter is not supported.
SPI_SETFOCUSBORDERWIDTHSets the height of the left and right edges of the focus rectangle drawn with DrawFocusRect to the value of the pvParam parameter.
Windows 2000: This parameter is not supported.
SPI_SETHIGHCONTRASTSets the parameters of the HighContrast accessibility feature. The pvParam parameter must point to a HIGHCONTRAST structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(HIGHCONTRAST).
SPI_SETMESSAGEDURATIONSets the time that notification pop-ups should be displayed, in seconds. The pvParam parameter must point to a ULONG that specifies the message duration.
Users with visual impairments or cognitive conditions such as ADHD and dyslexia might need a longer time to read the text in notification messages. This flag enables you to set the message duration.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETMOUSECLICKLOCKTurns the Mouse ClickLock accessibility feature on or off. This feature temporarily locks down the primary mouse button when that button is clicked and held down for the time specified by SPI_SETMOUSECLICKLOCKTIME. The uiParam parameter specifies TRUE for on, or FALSE for off. The default is off. For more information, see Remarks and About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_SETMOUSECLICKLOCKTIMEAdjusts the time delay before the primary mouse button is locked. The uiParam parameter should be set to 0. The pvParam parameter points to a DWORD that specifies the time delay in milliseconds. For example, specify 1000 for a 1 second delay. The default is 1200. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_SETMOUSEKEYSSets the parameters of the MouseKeys accessibility feature. The pvParam parameter must point to a MOUSEKEYS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(MOUSEKEYS).
SPI_SETMOUSESONARTurns the Sonar accessibility feature on or off. This feature briefly shows several concentric circles around the mouse pointer when the user presses and releases the CTRL key. The pvParam parameter specifies TRUE for on and FALSE for off. The default is off. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_SETMOUSEVANISHTurns the Vanish feature on or off. This feature hides the mouse pointer when the user types; the pointer reappears when the user moves the mouse. The pvParam parameter specifies TRUE for on and FALSE for off. The default is off. For more information, see About Mouse Input .
Windows 2000: This parameter is not supported.
SPI_SETSCREENREADERDetermines whether a screen review utility is running. The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETSERIALKEYSThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: The user should control this setting through the Control Panel.
SPI_SETSHOWSOUNDSTurns the ShowSounds accessibility feature on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETSOUNDSENTRYSets the parameters of the SoundSentry accessibility feature. The pvParam parameter must point to a SOUNDSENTRY structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYSSets the parameters of the StickyKeys accessibility feature. The pvParam parameter must point to a STICKYKEYS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYSSets the parameters of the ToggleKeys accessibility feature. The pvParam parameter must point to a TOGGLEKEYS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(TOGGLEKEYS).

The following are the desktop parameters.
Desktop parameterMeaning
SPI_GETCLEARTYPEDetermines whether ClearType is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if ClearType is enabled, or FALSE otherwise.
ClearType is a software technology that improves the readability of text on liquid crystal display (LCD) monitors.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETDESKWALLPAPERRetrieves the full path of the bitmap file for the desktop wallpaper. The pvParam parameter must point to a buffer to receive the NULL-terminated path string. Set the uiParam parameter to the size, in characters, of the pvParam buffer. The returned string will not exceed MAX_PATH characters. If there is no desktop wallpaper, the returned string is empty.
SPI_GETDROPSHADOWDetermines whether the drop shadow effect is enabled. The pvParam parameter must point to a BOOL variable that returns TRUE if enabled or FALSE if disabled.
Windows 2000: This parameter is not supported.
SPI_GETFLATMENUDetermines whether native User menus have flat menu appearance. The pvParam parameter must point to a BOOL variable that returns TRUE if the flat menu appearance is set, or FALSE otherwise.
Windows 2000: This parameter is not supported.
SPI_GETFONTSMOOTHINGDetermines whether the font smoothing feature is enabled. This feature uses font antialiasing to make font curves appear smoother by painting pixels at different gray levels.
The pvParam parameter must point to a BOOL variable that receives TRUE if the feature is enabled, or FALSE if it is not.
SPI_GETFONTSMOOTHINGCONTRASTRetrieves a contrast value that is used in ClearType smoothing. The pvParam parameter must point to a UINT that receives the information. Valid contrast values are from 1000 to 2200. The default value is 1400.
Windows 2000: This parameter is not supported.
SPI_GETFONTSMOOTHINGORIENTATIONRetrieves the font smoothing orientation. The pvParam parameter must point to a UINT that receives the information. The possible values are FE_FONTSMOOTHINGORIENTATIONBGR (blue-green-red) and FE_FONTSMOOTHINGORIENTATIONRGB (red-green-blue).
Windows XP/2000: This parameter is not supported until Windows XP with SP2.
SPI_GETFONTSMOOTHINGTYPERetrieves the type of font smoothing. The pvParam parameter must point to a UINT that receives the information. The possible values are FE_FONTSMOOTHINGSTANDARD and FE_FONTSMOOTHINGCLEARTYPE.
Windows 2000: This parameter is not supported.
SPI_GETWORKAREARetrieves the size of the work area on the primary display monitor. The work area is the portion of the screen not obscured by the system taskbar or by application desktop toolbars. The pvParam parameter must point to a RECT structure that receives the coordinates of the work area, expressed in virtual screen coordinates.
To get the work area of a monitor other than the primary display monitor, call the GetMonitorInfo function.
SPI_SETCLEARTYPETurns ClearType on or off. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to enable ClearType, or FALSE to disable it.
ClearType is a software technology that improves the readability of text on LCD monitors.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETCURSORSReloads the system cursors. Set the uiParam parameter to zero and the pvParam parameter to NULL.
SPI_SETDESKPATTERNSets the current desktop pattern by causing Windows to read the Pattern= setting from the WIN.INI file.
SPI_SETDESKWALLPAPERSets the desktop wallpaper. The value of the pvParam parameter determines the new wallpaper. To specify a wallpaper bitmap, set pvParam to point to a NULL-terminated string containing the full path to the bitmap file. Setting pvParam to "" removes the wallpaper. Setting pvParam to SETWALLPAPER_DEFAULT or NULL reverts to the default wallpaper.
The pvParam parameter can specify a .jpg file.
Windows Server 2003 and Windows XP/2000: The pvParam parameter cannot specify a .jpg file.
SPI_SETDROPSHADOWEnables or disables the drop shadow effect. Set pvParam to TRUE to enable the drop shadow effect or FALSE to disable it. You must also have CS_DROPSHADOW in the window class style.
Windows 2000: This parameter is not supported.
SPI_SETFLATMENUEnables or disables flat menu appearance for native User menus. Set pvParam to TRUE to enable flat menu appearance or FALSE to disable it.
When enabled, the menu bar uses COLOR_MENUBAR for the menubar background, COLOR_MENU for the menu-popup background, COLOR_MENUHILIGHT for the fill of the current menu selection, and COLOR_HILIGHT for the outline of the current menu selection. If disabled, menus are drawn using the same metrics and colors as in Windows 2000.
Windows 2000: This parameter is not supported.
SPI_SETFONTSMOOTHINGEnables or disables the font smoothing feature, which uses font antialiasing to make font curves appear smoother by painting pixels at different gray levels.
To enable the feature, set the uiParam parameter to TRUE. To disable the feature, set uiParam to FALSE.
SPI_SETFONTSMOOTHINGCONTRASTSets the contrast value used in ClearType smoothing. The pvParam parameter is the contrast value. Valid contrast values are from 1000 to 2200. The default value is 1400.
SPI_SETFONTSMOOTHINGTYPE must also be set to FE_FONTSMOOTHINGCLEARTYPE.
Windows 2000: This parameter is not supported.
SPI_SETFONTSMOOTHINGORIENTATIONSets the font smoothing orientation. The pvParam parameter is either FE_FONTSMOOTHINGORIENTATIONBGR (blue-green-red) or FE_FONTSMOOTHINGORIENTATIONRGB (red-green-blue).
Windows XP/2000: This parameter is not supported until Windows XP with SP2.
SPI_SETFONTSMOOTHINGTYPESets the font smoothing type. The pvParam parameter is either FE_FONTSMOOTHINGSTANDARD, if standard anti-aliasing is used, or FE_FONTSMOOTHINGCLEARTYPE, if ClearType is used. The default is FE_FONTSMOOTHINGSTANDARD.
SPI_SETFONTSMOOTHING must also be set.
Windows 2000: This parameter is not supported.
SPI_SETWORKAREASets the size of the work area. The work area is the portion of the screen not obscured by the system taskbar or by application desktop toolbars. The pvParam parameter is a pointer to a RECT structure that specifies the new work area rectangle, expressed in virtual screen coordinates. In a system with multiple display monitors, the function sets the work area of the monitor that contains the specified rectangle.

The following are the icon parameters.
Icon parameterMeaning
SPI_GETICONMETRICSRetrieves the metrics associated with icons. The pvParam parameter must point to an ICONMETRICS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONTRetrieves the logical font information for the current icon-title font. The uiParam parameter specifies the size of a LOGFONT structure, and the pvParam parameter must point to the LOGFONT structure to fill in.
SPI_GETICONTITLEWRAPDetermines whether icon-title wrapping is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
SPI_ICONHORIZONTALSPACINGSets or retrieves the width, in pixels, of an icon cell. The system uses this rectangle to arrange icons in large icon view.
To set this value, set uiParam to the new value and set pvParam to NULL. You cannot set this value to less than SM_CXICON.
To retrieve this value, pvParam must point to an integer that receives the current value.
SPI_ICONVERTICALSPACINGSets or retrieves the height, in pixels, of an icon cell.
To set this value, set uiParam to the new value and set pvParam to NULL. You cannot set this value to less than SM_CYICON.
To retrieve this value, pvParam must point to an integer that receives the current value.
SPI_SETICONMETRICSSets the metrics associated with icons. The pvParam parameter must point to an ICONMETRICS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(ICONMETRICS).
SPI_SETICONSReloads the system icons. Set the uiParam parameter to zero and the pvParam parameter to NULL.
SPI_SETICONTITLELOGFONTSets the font that is used for icon titles. The uiParam parameter specifies the size of a LOGFONT structure, and the pvParam parameter must point to a LOGFONT structure.
SPI_SETICONTITLEWRAPTurns icon-title wrapping on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.

The following are the input parameters. They include parameters related to the keyboard, mouse, input language, and the warning beeper.
Input parameterMeaning
SPI_GETBEEPDetermines whether the warning beeper is on.
The pvParam parameter must point to a BOOL variable that receives TRUE if the beeper is on, or FALSE if it is off.
SPI_GETBLOCKSENDINPUTRESETSRetrieves a BOOL indicating whether an application can reset the screensaver's timer by calling the SendInput function to simulate keyboard or mouse input. The pvParam parameter must point to a BOOL variable that receives TRUE if the simulated input will be blocked, or FALSE otherwise.
SPI_GETDEFAULTINPUTLANGRetrieves the input locale identifier for the system default input language. The pvParam parameter must point to an HKL variable that receives this value. For more information, see Languages, Locales, and Keyboard Layouts .
SPI_GETKEYBOARDCUESDetermines whether menu access keys are always underlined. The pvParam parameter must point to a BOOL variable that receives TRUE if menu access keys are always underlined, and FALSE if they are underlined only when the menu is activated by the keyboard.
SPI_GETKEYBOARDDELAYRetrieves the keyboard repeat-delay setting, which is a value in the range from 0 (approximately 250 ms delay) through 3 (approximately 1 second delay). The actual delay associated with each value may vary depending on the hardware. The pvParam parameter must point to an integer variable that receives the setting.
SPI_GETKEYBOARDPREFDetermines whether the user relies on the keyboard instead of the mouse, and wants applications to display keyboard interfaces that would otherwise be hidden. The pvParam parameter must point to a BOOL variable that receives TRUE if the user relies on the keyboard; or FALSE otherwise.
SPI_GETKEYBOARDSPEEDRetrieves the keyboard repeat-speed setting, which is a value in the range from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second). The actual repeat rates are hardware-dependent and may vary from a linear scale by as much as 20%. The pvParam parameter must point to a DWORD variable that receives the setting.
SPI_GETMOUSERetrieves the two mouse threshold values and the mouse acceleration. The pvParam parameter must point to an array of three integers that receives these values. See mouse_event for further information.
SPI_GETMOUSEHOVERHEIGHTRetrieves the height, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParam parameter must point to a UINT variable that receives the height.
SPI_GETMOUSEHOVERTIMERetrieves the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParam parameter must point to a UINT variable that receives the time.
SPI_GETMOUSEHOVERWIDTHRetrieves the width, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParam parameter must point to a UINT variable that receives the width.
SPI_GETMOUSESPEEDRetrieves the current mouse speed. The mouse speed determines how far the pointer will move based on the distance the mouse moves. The pvParam parameter must point to an integer that receives a value which ranges between 1 (slowest) and 20 (fastest). A value of 10 is the default. The value can be set by an end-user using the mouse control panel application or by an application using SPI_SETMOUSESPEED.
SPI_GETMOUSETRAILSDetermines whether the Mouse Trails feature is enabled. This feature improves the visibility of mouse cursor movements by briefly showing a trail of cursors and quickly erasing them.
The pvParam parameter must point to an integer variable that receives a value. If the value is zero or 1, the feature is disabled. If the value is greater than 1, the feature is enabled and the value indicates the number of cursors drawn in the trail. The uiParam parameter is not used.
Windows 2000: This parameter is not supported.
SPI_GETSNAPTODEFBUTTONDetermines whether the snap-to-default-button feature is enabled. If enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box. The pvParam parameter must point to a BOOL variable that receives TRUE if the feature is on, or FALSE if it is off.
SPI_GETWHEELSCROLLCHARSRetrieves the number of characters to scroll when the horizontal mouse wheel is moved. The pvParam parameter must point to a UINT variable that receives the number of lines. The default value is 3.
SPI_GETWHEELSCROLLLINESRetrieves the number of lines to scroll when the vertical mouse wheel is moved. The pvParam parameter must point to a UINT variable that receives the number of lines. The default value is 3.
SPI_SETBEEPTurns the warning beeper on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETBLOCKSENDINPUTRESETSDetermines whether an application can reset the screensaver's timer by calling the SendInput function to simulate keyboard or mouse input. The uiParam parameter specifies TRUE if the screensaver will not be deactivated by simulated input, or FALSE if the screensaver will be deactivated by simulated input.
SPI_SETDEFAULTINPUTLANGSets the default input language for the system shell and applications. The specified language must be displayable using the current system character set. The pvParam parameter must point to an HKL variable that contains the input locale identifier for the default language. For more information, see Languages, Locales, and Keyboard Layouts .
SPI_SETDOUBLECLICKTIMESets the double-click time for the mouse to the value of the uiParam parameter. The double-click time is the maximum number of milliseconds that can occur between the first and second clicks of a double-click. You can also call the SetDoubleClickTime function to set the double-click time. To get the current double-click time, call the GetDoubleClickTime function.
SPI_SETDOUBLECLKHEIGHTSets the height of the double-click rectangle to the value of the uiParam parameter.
The double-click rectangle is the rectangle within which the second click of a double-click must fall for it to be registered as a double-click.
To retrieve the height of the double-click rectangle, call GetSystemMetrics with the SM_CYDOUBLECLK flag.
SPI_SETDOUBLECLKWIDTHSets the width of the double-click rectangle to the value of the uiParam parameter.
The double-click rectangle is the rectangle within which the second click of a double-click must fall for it to be registered as a double-click.
To retrieve the width of the double-click rectangle, call GetSystemMetrics with the SM_CXDOUBLECLK flag.
SPI_SETKEYBOARDCUESSets the underlining of menu access key letters. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to always underline menu access keys, or FALSE to underline menu access keys only when the menu is activated from the keyboard.
SPI_SETKEYBOARDDELAYSets the keyboard repeat-delay setting. The uiParam parameter must specify 0, 1, 2, or 3, where zero sets the shortest delay approximately 250 ms) and 3 sets the longest delay (approximately 1 second). The actual delay associated with each value may vary depending on the hardware.
SPI_SETKEYBOARDPREFSets the keyboard preference. The uiParam parameter specifies TRUE if the user relies on the keyboard instead of the mouse, and wants applications to display keyboard interfaces that would otherwise be hidden; uiParam is FALSE otherwise.
SPI_SETKEYBOARDSPEEDSets the keyboard repeat-speed setting. The uiParam parameter must specify a value in the range from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second). The actual repeat rates are hardware-dependent and may vary from a linear scale by as much as 20%. If uiParam is greater than 31, the parameter is set to 31.
SPI_SETLANGTOGGLESets the hot key set for switching between input languages. The uiParam and pvParam parameters are not used. The value sets the shortcut keys in the keyboard property sheets by reading the registry again. The registry must be set before this flag is used. the path in the registry is
HKEY_CURRENT_USER\\Keyboard Layout\\Toggle
. Valid values are "1" = ALT+SHIFT, "2" = CTRL+SHIFT, and "3" = none.
SPI_SETMOUSESets the two mouse threshold values and the mouse acceleration. The pvParam parameter must point to an array of three integers that specifies these values. See mouse_event for further information.
SPI_SETMOUSEBUTTONSWAPSwaps or restores the meaning of the left and right mouse buttons. The uiParam parameter specifies TRUE to swap the meanings of the buttons, or FALSE to restore their original meanings.
To retrieve the current setting, call GetSystemMetrics with the SM_SWAPBUTTON flag.
SPI_SETMOUSEHOVERHEIGHTSets the height, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParam parameter to the new height.
SPI_SETMOUSEHOVERTIMESets the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle for TrackMouseEvent to generate a WM_MOUSEHOVER message. This is used only if you pass HOVER_DEFAULT in the dwHoverTime parameter in the call to TrackMouseEvent. Set the uiParamparameter to the new time.
The time specified should be between USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM. If uiParam is less than USER_TIMER_MINIMUM, the function will use USER_TIMER_MINIMUM. If uiParam is greater than USER_TIMER_MAXIMUM, the function will be USER_TIMER_MAXIMUM.
Windows Server 2003 and Windows XP: The operating system does not enforce the use of USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM until Windows Server 2003 with SP1 and Windows XP with SP2.
SPI_SETMOUSEHOVERWIDTHSets the width, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParam parameter to the new width.
SPI_SETMOUSESPEEDSets the current mouse speed. The pvParam parameter is an integer between 1 (slowest) and 20 (fastest). A value of 10 is the default. This value is typically set using the mouse control panel application.
SPI_SETMOUSETRAILSEnables or disables the Mouse Trails feature, which improves the visibility of mouse cursor movements by briefly showing a trail of cursors and quickly erasing them.
To disable the feature, set the uiParam parameter to zero or 1. To enable the feature, set uiParam to a value greater than 1 to indicate the number of cursors drawn in the trail.
Windows 2000: This parameter is not supported.
SPI_SETSNAPTODEFBUTTONEnables or disables the snap-to-default-button feature. If enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box. Set the uiParam parameter to TRUE to enable the feature, or FALSE to disable it. Applications should use the ShowWindow function when displaying a dialog box so the dialog manager can position the mouse cursor.
SPI_SETWHEELSCROLLCHARSSets the number of characters to scroll when the horizontal mouse wheel is moved. The number of characters is set from the uiParam parameter.
SPI_SETWHEELSCROLLLINESSets the number of lines to scroll when the vertical mouse wheel is moved. The number of lines is set from the uiParam parameter.
The number of lines is the suggested number of lines to scroll when the mouse wheel is rolled without using modifier keys. If the number is 0, then no scrolling should occur. If the number of lines to scroll is greater than the number of lines viewable, and in particular if it is WHEEL_PAGESCROLL (#defined as UINT_MAX), the scroll operation should be interpreted as clicking once in the page down or page up regions of the scroll bar.

The following are the menu parameters.
Menu parameterMeaning
SPI_GETMENUDROPALIGNMENTDetermines whether pop-up menus are left-aligned or right-aligned, relative to the corresponding menu-bar item. The pvParam parameter must point to a BOOL variable that receives TRUE if right-aligned, or FALSE otherwise.
SPI_GETMENUFADEDetermines whether menu fade animation is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE when fade animation is enabled and FALSE when it isdisabled. If fade animation is disabled, menus use slide animation. This flag is ignored unless menu animation is enabled, which you can do using the SPI_SETMENUANIMATION flag. For more information, see AnimateWindow .
SPI_GETMENUSHOWDELAYRetrieves the time, in milliseconds, that the system waits before displaying a shortcut menu when the mouse cursor is over a submenu item. The pvParam parameter must point to a DWORD variable that receives the time of the delay.
SPI_SETMENUDROPALIGNMENTSets the alignment value of pop-up menus. The uiParam parameter specifies TRUE for right alignment, or FALSE for left alignment.
SPI_SETMENUFADEEnables or disables menu fade animation. Set pvParam to TRUE to enable the menu fade effect or FALSE to disable it. If fade animation is disabled, menus use slide animation. he The menu fade effect is possible only if the system has a color depth of more than 256 colors. This flag is ignored unless SPI_MENUANIMATION is also set. For more information, see AnimateWindow .
SPI_SETMENUSHOWDELAYSets uiParam to the time, in milliseconds, that the system waits before displaying a shortcut menu when the mouse cursor is over a submenu item.

The following are the power parameters.
Beginning with Windows Server 2008 and Windows Vista, these power parameters are not supported. Instead, to determine the current display power state, an application should register for GUID_MONITOR_POWER_STATE notifications. To determine the current display power down time-out, an application should register for notification of changes to the GUID_VIDEO_POWERDOWN_TIMEOUT power setting. For more information, see Registering for Power Events .
Windows Server 2003 and Windows XP/2000: To determine the current display power state, use the following power parameters.
Power parameterMeaning
SPI_GETLOWPOWERACTIVEThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Determines whether the low-power phase of screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE if disabled. This flag is supported for 32-bit applications only.
SPI_GETLOWPOWERTIMEOUTThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Retrieves the time-out value for the low-power phase of screen saving. The pvParam parameter must point to an integer variable that receives the value. This flag is supported for 32-bit applications only.
SPI_GETPOWEROFFACTIVEThis parameter is not supported. When the power-off phase of screen saving is enabled, the GUID_VIDEO_POWERDOWN_TIMEOUT power setting is greater than zero.
Windows Server 2003 and Windows XP/2000: Determines whether the power-off phase of screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE if disabled. This flag is supported for 32-bit applications only.
SPI_GETPOWEROFFTIMEOUTThis parameter is not supported. Instead, check the GUID_VIDEO_POWERDOWN_TIMEOUT power setting.
Windows Server 2003 and Windows XP/2000: Retrieves the time-out value for the power-off phase of screen saving. The pvParam parameter must point to an integer variable that receives the value. This flag is supported for 32-bit applications only.
SPI_SETLOWPOWERACTIVEThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Activates or deactivates the low-power phase of screen saving. Set uiParam to 1 to activate, or zero to deactivate. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETLOWPOWERTIMEOUTThis parameter is not supported.
Windows Server 2003 and Windows XP/2000: Sets the time-out value, in seconds, for the low-power phase of screen saving. The uiParam parameter specifies the new value. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETPOWEROFFACTIVEThis parameter is not supported. Instead, set the GUID_VIDEO_POWERDOWN_TIMEOUT power setting.
Windows Server 2003 and Windows XP/2000: Activates or deactivates the power-off phase of screen saving. Set uiParam to 1 to activate, or zero to deactivate. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.
SPI_SETPOWEROFFTIMEOUTThis parameter is not supported. Instead, set the GUID_VIDEO_POWERDOWN_TIMEOUT power setting to a time-out value.
Windows Server 2003 and Windows XP/2000: Sets the time-out value, in seconds, for the power-off phase of screen saving. The uiParam parameter specifies the new value. The pvParam parameter must be NULL. This flag is supported for 32-bit applications only.

The following are the screen saver parameters.
Screen saver parameterMeaning
SPI_GETSCREENSAVEACTIVEDetermines whether screen saving is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if screen saving is enabled, or FALSE otherwise.
Windows 7, Windows Server 2008 R2, and Windows 2000: The function returns TRUE even when screen saving is not enabled. For more information and a workaround, see KB318781 .
SPI_GETSCREENSAVERRUNNINGDetermines whether a screen saver is currently running on the window station of the calling process. The pvParam parameter must point to a BOOL variable that receives TRUE if a screen saver is currently running, or FALSE otherwise. Note that only the interactive window station, WinSta0, can have a screen saver running.
SPI_GETSCREENSAVESECUREDetermines whether the screen saver requires a password to display the Windows desktop. The pvParam parameter must point to a BOOL variable that receives TRUE if the screen saver requires a password, or FALSE otherwise. The uiParam parameter is ignored.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_GETSCREENSAVETIMEOUTRetrieves the screen saver time-out value, in seconds. The pvParam parameter must point to an integer variable that receives the value.
SPI_SETSCREENSAVEACTIVESets the state of the screen saver. The uiParam parameter specifies TRUE to activate screen saving, or FALSE to deactivate it.
SPI_SETSCREENSAVESECURESets whether the screen saver requires the user to enter a password to display the Windows desktop. The uiParam parameter is a BOOL variable. The pvParam parameter is ignored. Set uiParam to TRUE to require a password, or FALSE to not require a password.
Windows Server 2003 and Windows XP/2000: This parameter is not supported.
SPI_SETSCREENSAVETIMEOUTSets the screen saver time-out value to the value of the uiParam parameter. This value is the amount of time, in seconds, that the system must be idle before the screen saver activates.

The following are the time-out parameters for applications and services.
Time-out parameterMeaning
SPI_GETHUNGAPPTIMEOUTRetrieves the number of milliseconds that a thread can go without dispatching a message before the system considers it unresponsive. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWAITTOKILLTIMEOUTRetrieves the number of milliseconds that the system waits before terminating an application that does not respond to a shutdown request. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWAITTOKILLSERVICETIMEOUTRetrieves the number of milliseconds that the service control manager waits before terminating a service that does not respond to a shutdown request. The pvParam parameter must point to an integer variable that receives the value.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETHUNGAPPTIMEOUTSets the hung application time-out to the value of the uiParam parameter. This value is the number of milliseconds that a thread can go without dispatching a message before the system considers it unresponsive.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWAITTOKILLTIMEOUTSets the application shutdown request time-out to the value of the uiParam parameter. This value is the number of milliseconds that the system waits before terminating an application that does not respond to a shutdown request.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWAITTOKILLSERVICETIMEOUTSets the service shutdown request time-out to the value of the uiParam parameter. This value is the number of milliseconds that the system waits before terminating a service that does not respond to a shutdown request.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.

The following are the UI effects. The SPI_SETUIEFFECTS value is used to enable or disable all UI effects at once. This table contains the complete list of UI effect values.
UI effects parameterMeaning
SPI_GETCOMBOBOXANIMATIONDetermines whether the slide-open effect for combo boxes is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
SPI_GETCURSORSHADOWDetermines whether the cursor has a shadow around it. The pvParam parameter must point to a BOOL variable that receives TRUE if the shadow is enabled, FALSE if it is disabled. This effect appears only if the system has a color depth of more than 256 colors.
SPI_GETGRADIENTCAPTIONSDetermines whether the gradient effect for window title bars is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled. For more information about the gradient effect, see the GetSysColor function.
SPI_GETHOTTRACKINGDetermines whether hot tracking of user-interface elements, such as menu names on menu bars, is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
Hot tracking means that when the cursor moves over an item, it is highlighted but not selected. You can query this value to decide whether to use hot tracking in the user interface of your application.
SPI_GETLISTBOXSMOOTHSCROLLINGDetermines whether the smooth-scrolling effect for list boxes is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE for enabled, or FALSE for disabled.
SPI_GETMENUANIMATIONDetermines whether the menu animation feature is enabled. This master switch must be on to enable menu animation effects. The pvParam parameter must point to a BOOL variable that receives TRUE if animation is enabled and FALSE if it is disabled.
If animation is enabled, SPI_GETMENUFADE indicates whether menus use fade or slide animation.
SPI_GETMENUUNDERLINESSame as SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADEDetermines whether the selection fade effect is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE if disabled.
The selection fade effect causes the menu item selected by the user to remain on the screen briefly while fading out after the menu is dismissed.
SPI_GETTOOLTIPANIMATIONDetermines whether ToolTip animation is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled or FALSE if disabled. If ToolTip animation is enabled, SPI_GETTOOLTIPFADE indicates whether ToolTips use fade or slide animation.
SPI_GETTOOLTIPFADEIf SPI_SETTOOLTIPANIMATION is enabled, SPI_GETTOOLTIPFADE indicates whether ToolTip animation uses a fade effect or a slide effect. The pvParam parameter must point to a BOOL variable that receives TRUE for fade animation or FALSE for slide animation. For more information on slide and fade effects, see AnimateWindow .
SPI_GETUIEFFECTSDetermines whether UI effects are enabled or disabled. The pvParam parameter must point to a BOOL variable that receives TRUE if all UI effects are enabled, or FALSE if they are disabled.
SPI_SETCOMBOBOXANIMATIONEnables or disables the slide-open effect for combo boxes. Set the pvParam parameter to TRUE to enable the gradient effect, or FALSE to disable it.
SPI_SETCURSORSHADOWEnables or disables a shadow around the cursor. The pvParam parameter is a BOOL variable. Set pvParam to TRUE to enable the shadow or FALSE to disable the shadow. This effect appears only if the system has a color depth of more than 256 colors.
SPI_SETGRADIENTCAPTIONSEnables or disables the gradient effect for window title bars. Set the pvParam parameter to TRUE to enable it, or FALSE to disable it. The gradient effect is possible only if the system has a color depth of more than 256 colors. For more information about the gradient effect, see the GetSysColor function.
SPI_SETHOTTRACKINGEnables or disables hot tracking of user-interface elements such as menu names on menu bars. Set the pvParam parameter to TRUE to enable it, or FALSE to disable it.
Hot-tracking means that when the cursor moves over an item, it is highlighted but not selected.
SPI_SETLISTBOXSMOOTHSCROLLINGEnables or disables the smooth-scrolling effect for list boxes. Set the pvParam parameter to TRUE to enable the smooth-scrolling effect, or FALSE to disable it.
SPI_SETMENUANIMATIONEnables or disables menu animation. This master switch must be on for any menu animation to occur. The pvParam parameter is a BOOL variable; set pvParam to TRUE to enable animation and FALSE to disable animation.
If animation is enabled, SPI_GETMENUFADE indicates whether menus use fade or slide animation.
SPI_SETMENUUNDERLINESSame as SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADESet pvParam to TRUE to enable the selection fade effect or FALSE to disable it.
The selection fade effect causes the menu item selected by the user to remain on the screen briefly while fading out after the menu is dismissed. The selection fade effect is possible only if the system has a color depth of more than 256 colors.
SPI_SETTOOLTIPANIMATIONSet pvParam to TRUE to enable ToolTip animation or FALSE to disable it. If enabled, you can use SPI_SETTOOLTIPFADE to specify fade or slide animation.
SPI_SETTOOLTIPFADEIf the SPI_SETTOOLTIPANIMATION flag is enabled, use SPI_SETTOOLTIPFADE to indicate whether ToolTip animation uses a fade effect or a slide effect. Set pvParam to TRUE for fade animation or FALSE for slide animation. The tooltip fade effect is possible only if the system has a color depth of more than 256 colors. For more information on the slide and fade effects, see the AnimateWindow function.
SPI_SETUIEFFECTSEnables or disables UI effects. Set the pvParam parameter to TRUE to enable all UI effects or FALSE to disable all UI effects.

The following are the window parameters.
Window parameterMeaning
SPI_GETACTIVEWINDOWTRACKINGDetermines whether active window tracking (activating the window the mouse is on) is on or off. The pvParam parameter must point to a BOOL variable that receives TRUE for on, or FALSE for off.
SPI_GETACTIVEWNDTRKZORDERDetermines whether windows activated through active window tracking will be brought to the top. The pvParam parameter must point to a BOOL variable that receives TRUE for on, or FALSE for off.
SPI_GETACTIVEWNDTRKTIMEOUTRetrieves the active window tracking delay, in milliseconds. The pvParam parameter must point to a DWORD variable that receives the time.
SPI_GETANIMATIONRetrieves the animation effects associated with user actions. The pvParam parameter must point to an ANIMATIONINFO structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(ANIMATIONINFO).
SPI_GETBORDERRetrieves the border multiplier factor that determines the width of a window's sizing border. The pvParam parameter must point to an integer variable that receives this value.
SPI_GETCARETWIDTHRetrieves the caret width in edit controls, in pixels. The pvParam parameter must point to a DWORD variable that receives this value.
SPI_GETDOCKMOVINGDetermines whether a window is docked when it is moved to the top, left, or right edges of a monitor or monitor array. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETDRAGFROMMAXIMIZEDetermines whether a maximized window is restored when its caption bar is dragged. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETDRAGFULLWINDOWSDetermines whether dragging of full windows is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
SPI_GETFOREGROUNDFLASHCOUNTRetrieves the number of times SetForegroundWindow will flash the taskbar button when rejecting a foreground switch request. The pvParam parameter must point to a DWORD variable that receives the value.
SPI_GETFOREGROUNDLOCKTIMEOUTRetrieves the amount of time following user input, in milliseconds, during which the system will not allow applications to force themselves into the foreground. The pvParam parameter must point to a DWORD variable that receives the time.
SPI_GETMINIMIZEDMETRICSRetrieves the metrics associated with minimized windows. The pvParam parameter must point to a MINIMIZEDMETRICS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLDRetrieves the threshold in pixels where docking behavior is triggered by using a mouse to drag a window to the edge of a monitor or monitor array. The default threshold is 1. The pvParam parameter must point to a DWORD variable that receives the value.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETMOUSEDRAGOUTTHRESHOLDRetrieves the threshold in pixels where undocking behavior is triggered by using a mouse to drag a window from the edge of a monitor or a monitor array toward the center. The default threshold is 20.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETMOUSESIDEMOVETHRESHOLDRetrieves the threshold in pixels from the top of a monitor or a monitor array where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETNONCLIENTMETRICSRetrieves the metrics associated with the nonclient area of nonminimized windows. The pvParam parameter must point to a NONCLIENTMETRICS structure that receives the information. Set the cbSize member of this structure and the uiParam parameter to sizeof(NONCLIENTMETRICS).
SPI_GETPENDOCKTHRESHOLDRetrieves the threshold in pixels where docking behavior is triggered by using a pen to drag a window to the edge of a monitor or monitor array. The default is 30.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETPENDRAGOUTTHRESHOLDRetrieves the threshold in pixels where undocking behavior is triggered by using a pen to drag a window from the edge of a monitor or monitor array toward its center. The default threshold is 30.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETPENSIDEMOVETHRESHOLDRetrieves the threshold in pixels from the top of a monitor or monitor array where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETSHOWIMEUIDetermines whether the IME status window is visible (on a per-user basis). The pvParam parameter must point to a BOOL variable that receives TRUE if the status window is visible, or FALSE if it is not.
SPI_GETSNAPSIZINGDetermines whether a window is vertically maximized when it is sized to the top or bottom of a monitor or monitor array. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Use SPI_GETWINARRANGING to determine whether this behavior is enabled.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_GETWINARRANGINGDetermines whether window arrangement is enabled. The pvParam parameter must point to a BOOL variable that receives TRUE if enabled, or FALSE otherwise.
Window arrangement reduces the number of mouse, pen, or touch interactions needed to move and size top-level windows by simplifying the default behavior of a window when it is dragged or sized.
The following parameters retrieve individual window arrangement settings:
SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETACTIVEWINDOWTRACKINGSets active window tracking (activating the window the mouse is on) either on or off. Set pvParam to TRUE for on or FALSE for off.
SPI_SETACTIVEWNDTRKZORDERDetermines whether or not windows activated through active window tracking should be brought to the top. Set pvParam to TRUE for on or FALSE for off.
SPI_SETACTIVEWNDTRKTIMEOUTSets the active window tracking delay. Set pvParam to the number of milliseconds to delay before activating the window under the mouse pointer.
SPI_SETANIMATIONSets the animation effects associated with user actions. The pvParam parameter must point to an ANIMATIONINFO structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(ANIMATIONINFO).
SPI_SETBORDERSets the border multiplier factor that determines the width of a window's sizing border. The uiParam parameter specifies the new value.
SPI_SETCARETWIDTHSets the caret width in edit controls. Set pvParam to the desired width, in pixels. The default and minimum value is 1.
SPI_SETDOCKMOVINGSets whether a window is docked when it is moved to the top, left, or right docking targets on a monitor or monitor array. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETDRAGFROMMAXIMIZESets whether a maximized window is restored when its caption bar is dragged. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETDRAGFULLWINDOWSSets dragging of full windows either on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.
SPI_SETDRAGHEIGHTSets the height, in pixels, of the rectangle used to detect the start of a drag operation. Set uiParam to the new value. To retrieve the drag height, call GetSystemMetrics with the SM_CYDRAG flag.
SPI_SETDRAGWIDTHSets the width, in pixels, of the rectangle used to detect the start of a drag operation. Set uiParam to the new value. To retrieve the drag width, call GetSystemMetrics with the SM_CXDRAG flag.
SPI_SETFOREGROUNDFLASHCOUNTSets the number of times SetForegroundWindow will flash the taskbar button when rejecting a foreground switch request. Set pvParam to the number of times to flash.
SPI_SETFOREGROUNDLOCKTIMEOUTSets the amount of time following user input, in milliseconds, during which the system does not allow applications to force themselves into the foreground. Set pvParam to the new time-out value.
The calling thread must be able to change the foreground window, otherwise the call fails.
SPI_SETMINIMIZEDMETRICSSets the metrics associated with minimized windows. The pvParam parameter must point to a MINIMIZEDMETRICS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLDSets the threshold in pixels where docking behavior is triggered by using a mouse to drag a window to the edge of a monitor or monitor array. The default threshold is 1. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETMOUSEDRAGOUTTHRESHOLDSets the threshold in pixels where undocking behavior is triggered by using a mouse to drag a window from the edge of a monitor or monitor array to its center. The default threshold is 20. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETMOUSESIDEMOVETHRESHOLDSets the threshold in pixels from the top of the monitor where a vertically maximized window is restored when dragged with the mouse. The default threshold is 50. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETNONCLIENTMETRICSSets the metrics associated with the nonclient area of nonminimized windows. The pvParam parameter must point to a NONCLIENTMETRICS structure that contains the new parameters. Set the cbSize member of this structure and the uiParam parameter to sizeof(NONCLIENTMETRICS). Also, the lfHeight member of the LOGFONT structure must be a negative value.
SPI_SETPENDOCKTHRESHOLDSets the threshold in pixels where docking behavior is triggered by using a pen to drag a window to the edge of a monitor or monitor array. The default threshold is 30. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETPENDRAGOUTTHRESHOLDSets the threshold in pixels where undocking behavior is triggered by using a pen to drag a window from the edge of a monitor or monitor array to its center. The default threshold is 30. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETPENSIDEMOVETHRESHOLDSets the threshold in pixels from the top of the monitor where a vertically maximized window is restored when dragged with a pen. The default threshold is 50. The pvParam parameter must point to a DWORD variable that contains the new value.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETSHOWIMEUISets whether the IME status window is visible or not on a per-user basis. The uiParam parameter specifies TRUE for on or FALSE for off.
SPI_SETSNAPSIZINGSets whether a window is vertically maximized when it is sized to the top or bottom of the monitor. Set pvParam to TRUE for on or FALSE for off.
SPI_GETWINARRANGING must be TRUE to enable this behavior.
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.
SPI_SETWINARRANGINGSets whether window arrangement is enabled. Set pvParam to TRUE for on or FALSE for off.
Window arrangement reduces the number of mouse, pen, or touch interactions needed to move and size top-level windows by simplifying the default behavior of a window when it is dragged or sized.
The following parameters set individual window arrangement settings:
SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP/2000: This parameter is not supported.

uiParam [in]
A parameter whose usage and format depends on the system parameter being queried or set. For more information about system-wide parameters, see the uiAction parameter. If not otherwise indicated, you must specify zero for this parameter.
pvParam [in, out]
A parameter whose usage and format depends on the system parameter being queried or set. For more information about system-wide parameters, see the uiAction parameter. If not otherwise indicated, you must specify NULL for this parameter.
fWinIni [in]
If a system parameter is being set, specifies whether the user profile is to be updated, and if so, whether the WM_SETTINGCHANGE message is to be broadcast to all top-level windows to notify them of the change.
This parameter can be zero if you don't want to update the user profile or broadcast the WM_SETTINGCHANGE message, or it can be one or more of the following values.
ValueMeaning
SPIF_UPDATEINIFILEWrites the new system-wide parameter setting to the user profile.
SPIF_SENDCHANGEBroadcasts the WM_SETTINGCHANGE message after updating the user profile.
SPIF_SENDWININICHANGESame as SPIF_SENDCHANGE.

Return Value
If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError .
Remarks
This function is intended for use with applications that allow the user to customize the environment.
A keyboard layout name should be derived from the hexadecimal value of the language identifier corresponding to the layout. For example, U.S. English has a language identifier of 0x0409, so the primary U.S. English layout is named "00000409". Variants of U.S. English layout, such as the Dvorak layout, are named "00010409", "00020409" and so on. For a list of the primary language identifiers and sublanguage identifiers that make up a language identifier, see the MAKELANGID macro.
There is a difference between the High Contrast color scheme and the High Contrast Mode. The High Contrast color scheme changes the system colors to colors that have obvious contrast; you switch to this color scheme by using the Display Options in the control panel. The High Contrast Mode, which uses SPI_GETHIGHCONTRAST and SPI_SETHIGHCONTRAST, advises applications to modify their appearance for visually-impaired users. It involves such things as audible warning to users and customized color scheme (using the Accessibility Options in the control panel). For more information, see HIGHCONTRAST . For more information on general accessibility features, see Accessibility .
During the time that the primary button is held down to activate the Mouse ClickLock feature, the user can move the mouse. Once the primary button is locked down, releasing the primary button does not result in a WM_LBUTTONUP message. Thus, it will appear to an application that the primary button is still down. Any subsequent button message releases the primary button, sending a WM_LBUTTONUP message to the application, thus the button can be unlocked programmatically or through the user clicking any button.
Examples
For an example, see Getting Hardware Information .
Requirements
Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinuser.h (include Windows.h)
LibraryUser32.lib
DLLUser32.dll
Unicode and ANSI namesSystemParametersInfoW (Unicode) and SystemParametersInfoA (ANSI)
See Also
ACCESSTIMEOUT
ANIMATIONINFO
AUDIODESCRIPTION
FILTERKEYS
HIGHCONTRAST
ICONMETRICS
LOGFONT
MAKELANGID
MINIMIZEDMETRICS
MOUSEKEYS
NONCLIENTMETRICS
RECT
SERIALKEYS
SOUNDSENTRY
STICKYKEYS
TOGGLEKEYS
WM_SETTINGCHANGE
Send comments about this topic to Microsoft
Build date: 8/27/2009
＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/ms724947(VS.85).aspx\n
随便看

　

windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。

　

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间：2024/10/6 13:19:45