SHACTIVATEINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure sets members for the SHHandleWMActivate function.

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 SHACTIVATEINFO structure.

• 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 SHACTIVATEINFO structure must be zero-initialized before calling the SHHandleWMActivate function the first time. In addition, the cbSize member should be set to the size of the variable of type SHACTIVATEINFO. For example,

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_CREATE or WM_INITDIALOG processing.

Requirements