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 structure sets members for the SHHandleWMActivatefunction.

Syntax 

typedef struct {
  DWORD 
cbSize.;
  HWND 
hwndLastFocus.;
  UINT 
fSipUp.:1;
  UINT 
fSipOnDeactivation. :1;
  UINT 
fActive :1;
  UINT 
fReserved :29;
} SHACTIVATEINFO, *PSHACTIVATEINFO;

Members

cbSize

Size of SHACTIVATEINFOstructure.

hwndLastFocus

Handle to the window that had focus when losing activation. Focus will be restored to this window when gaining activation.

fSipUp

Current state of the input panel.

fSipOnDeactivation

State of the input panel when losing activation.

fActive

Set this member to TRUE if the window is active and FALSE if it is inactive.

fReserved

Reserved for future use; set to 0.

Remarks

The SHACTIVATEINFOstructure must be zero-initialized before calling the SHHandleWMActivatefunction the first time. In addition, the cbSizemember should be set to the size of the variable of type SHACTIVATEINFO. For example,

Copy Code 
static SHACTIVATEINFO shellactinfo;
// Initialize the shell activate info structure 
// before calling SHHandleWMActivate function
memset(&shellactinfo, 0, sizeof (shellactinfo));
shellactinfo.cbSize = sizeof (shellactinfo);

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