SHHandleWMSettingChange (Windows CE 5.0)

Send Feedback

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 a Windows Mobile-based Smartphone, 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.
  • psai
    [in] Pointer to a SHACTIVATEINFO structure. This should be a pointer to the same memory that you pass to SHHandleWMActivate.

Return Values

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

Pocket PC: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: aygshell.h
Library: aygshell.lib

See Also

WM_SETTINGCHANGE | SystemParametersInfo | SHACTIVATEINFO | SHHandleWMActivate

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.