Share via

PSN_SETACTIVE (Compact 2013)

  • Article

3/28/2014

This message notifies a page that it is about to be activated. It is sent in the form of a WM_NOTIFY message.

Syntax

PSN_SETACTIVE lppsn = (LPPSHNOTIFY) lParam;

Parameters

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

Remarks

The lParam member of this structure does not contain any information.

The PSHNOTIFY 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 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 SetWindowLong function with the DWL_MSGRESULT value, and the dialog box procedure must return TRUE.

Requirements

Header

prsht.h

See Also

Reference

Property Sheets Notifications
SetWindowLong
WM_INITDIALOG
WM_NOTIFY
NMHDR
PSHNOTIFY