Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 hwndshould 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 wParamof the WM_SETTINGCHANGE message.

lParam

[in] Specifies the lParamof the WM_SETTINGCHANGE message.

psai

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

Return Value

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

Remarks

If the window specified in hwndshould be sized based on the position of the input panel, then call this function to size your window when it receives the WM_SETTINGCHANGEmessage.

When the input panel is raised, the window specified in hwndwill 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 hwndwill be sized from just below the taskbar or navigation bar to the bottom of the screen.

If wParamis SPI_SETSIPINFO, this function will size the window specified in hwndbased on the current position of the input panel. For more information on SPI_SETSIPINFO, see SystemParametersInfo.

The SHACTIVATEINFOstructure must be zero-initialized before calling the SHHandleWMSettingChangefunction the first time. Typically, this is done during WM_CREATEor WM_INITDIALOGprocessing.

Note:
Make sure to zero-initialize SHACTIVATEINFOas early as possible within WM_CREATEor WM_INITDIALOGto 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