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 message notifies a page that it is about to be activated. It is sent in the form of a WM_NOTIFYmessage.

Syntax 

PSN_SETACTIVE 
lppsn = (LPPSHNOTIFY) 
lParam;

Parameters

lppsn

Long pointer to a PSHNOTIFYstructure that contains information about the notification.

Return Value

Returns zero to accept the activation, or -1 to activate the next or the previous page (depending on whether the user clicked the Nextor Backbutton). To set the activation to a particular page, return the resource identifier of the page.

Remarks

The lParammember of this structure does not contain any information.

The PSHNOTIFYstructure contains an NMHDRstructure as its first member, hdr. The hwndFrommember of this NMHDRstructure contains the handle to the property sheet.

The PSN_SETACTIVE message is sent before the page is visible. An application can use this message to initialize data in the page.

To set the return value, the dialog box procedure for the page must use the SetWindowLongfunction with the DWL_MSGRESULT value, and the dialog box procedure must return TRUE.

Requirements

Header prsht.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also