SHHandleWMSettingChange (Compact 2013)

3/28/2014

This function is used to help manage the software-based input panel (SIP) and your application. If the window specified in hwnd should size based on the position of the SIP, then call this function to size your window when the window receives the WM_SETTINGCHANGE message.

Syntax

WINSHELLAPI BOOL SHHandleWMSettingChange(
  HWND hwnd,
  WPARAM wParam,
  LPARAM lParam,
  SHACTIVATEINFO * psai
);

Parameters

  • hwnd
    [in] Handle to the window that should be sized for the current position of the SIP.
  • wParam
    [in] Specifies the wParam of the WM_SETTINGCHANGE message.
  • lParam
    [in] Specifies the lParam of the WM_SETTINGCHANGE message.

Return Value

This function returns TRUE if it is successful and FALSE if it fails.

Remarks

If the window specified in hwnd should be sized based on the position of the SIP, then call this function to size your window when it receives the WM_SETTINGCHANGE message.

When the SIP is raised, the window specified in hwnd will be sized from just below the taskbar or navigation bar to just above the top of the SIP. When the SIP is lowered, the window specified hwnd will be sized from just below the taskbar or navigation bar to the bottom of the screen.

If wParam is SPI_SETSIPINFO, this function will size the window specified in hwnd based on the current position of the SIP. For more information on SPI_SETSIPINFO, see SystemParametersInfo.

The SHACTIVATEINFO structure must be zero-initialized before calling the SHHandleWMSettingChange function the first time. Typically, this is done during WM_CREATE or WM_INITDIALOG processing.

Note

Make sure to zero-initialize SHACTIVATEINFO as early as possible within WM_CREATE or WM_INITDIALOG to avoid a runtime error.

Requirements

Header

aygshell.h

Library

aygshell.lib

See Also

Reference

Shell Functions
WM_SETTINGCHANGE
SystemParametersInfo
SHACTIVATEINFO
SHHandleWMActivate

  • Last updated on