Share via

SHHandleWMSettingChange

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Note

On Windows Mobile Standard, this function is stubbed out. It is available to call, but the implementation does nothing.

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 input panel.
  • 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 input panel, then call this function to size your window when it receives the WM_SETTINGCHANGE message.

When the input panel 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 input panel. When the input panel 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 input panel. 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
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also

Reference

WM_SETTINGCHANGE
SystemParametersInfo
SHACTIVATEINFO
SHHandleWMActivate