PSN_SETACTIVE notification code

Notifies a page that it is about to be activated. This notification code is sent in the form of a WM_NOTIFY message.


    lppsn = (LPPSHNOTIFY) lParam; 



Pointer to a PSHNOTIFY structure that contains information about the notification code. This structure contains an NMHDR structure as its first member, hdr. The hwndFrom member of this NMHDR structure contains the handle to the property sheet. The lParam member of the PSHNOTIFY structure does not contain any information.

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 Next or Back button). To set the activation to a particular page, return the resource identifier of the page.


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


The property sheet is in the process of manipulating the list of pages when the PSN_SETACTIVE notification code is sent. Do not attempt to add, remove, or insert pages while handling this notification code. Doing so will have unpredictable results.

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


Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]