Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SHHandleWMSettingChange

Windows Mobile 6.5
A version of this page is also available for
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.

Aa930183.note(en-us,MSDN.10).gifNote:
On Windows Mobile Standard, this function is stubbed out. It is available to call, but the implementation does nothing.


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

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.

psai

[in] Pointer to a SHACTIVATEINFO structure. This should be a pointer to the same memory that you pass to SHHandleWMActivate.

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

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.

Aa930183.note(en-us,MSDN.10).gifNote:
Make sure to zero-initialize SHACTIVATEINFO as early as possible within WM_CREATE or WM_INITDIALOG to avoid a runtime error.

Headeraygshell.h
Libraryaygshell.lib
Windows Embedded CEWindows CE 3.0 and later
Windows MobilePocket PC 2000 and later

Community Additions

Show:
© 2015 Microsoft