SystemParametersInfo for Gestures (Compact 2013)

3/28/2014

You can use this function to query or set system-wide parameters and update the user profile at the same time. This topic covers system parameters that are specific to touch gesture metrics. For more information on other system parameters, see SystemParametersInfo.

Syntax

BOOL SystemParametersInfo( 
  UINT uiAction, 
  UINT uiParam, 
  PVOID pvParam, 
  UINT fWinIni
);

Parameters

• uiAction
  [in] Specifies the system-wide parameter to query or set. You can set this parameter to one of the following values if the SYSGEN_TOUCHGESTURE sysgen is included in your OS design.

  Value	Description
  SPI_GETGESTUREMETRICS	Retrieves information about gesture metrics. The pvParam parameter points to a GESTUREMETRICS structure that receives the information.
  SPI_SETGESTUREMETRICS	Sets gesture properties. The pvParam parameter points to a GESTUREMETRICS structure that contains the new values.

• uiParam
  [in] For gesture metrics, you must specify 0 (zero) for this parameter.

• pvParam
  [out] For gesture metrics, this value is a pointer to a GESTUREMETRICS structure.

• fWinIni
  [in] Specifies whether to update the user profile, and if so, whether to broadcast the WM_SETTINGCHANGE message to all top-level windows to notify them of the change. Set this parameter to 0 (zero) if you are using this function to query parameters. To set parameters, set this to one of the following values.

  Value	Description
  SPIF_UPDATEINIFILE	Writes the new system-wide parameter setting to the user profile.
  SPIF_SENDCHANGE	Broadcasts the WM_SETTINGCHANGE message.

Return Value

Returns true if function succeeds; otherwise, false. To retrieve extended error information, call GetLastError.

If the SYSGEN_TOUCHGESTURE sysgen is not set, calling SystemParametersInfo with a uiAction of SPI_GETGESTUREMETRICS or SPI_SETGESTUREMETRICS will return false, and GetLastError will return ERROR_CALL_NOT_IMPLEMENTED.

Remarks

Windows Embedded Compact supports only the Unicode version of this function.

You can use this function with applications, such as Control Panel, so that the user can customize the environment.

Requirements

See Also

Reference

Gesture Functions
SystemParametersInfo

Concepts

Touch Gestures