This notification message notifies a page that it is about to be activated. It is sent in the form of a WM_NOTIFY message.
At a Glance
| Header file: | Prsht.h |
| Windows CE versions: | 1.0 and later |
Syntax
PSN_SETACTIVE lpnmhdr = (NMHDR FAR *) lParam;
Parameters
lppsn
Long pointer to a PSHNOTIFY structure that contains information about the notification. The lParam member of this structure does not contain any information. The hwndFrom member of the hdr member of this structure contains the handle to the property sheet.
Return Values
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 PSN_SETACTIVE notification message is sent before the page is visible. An application can use this notification 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.
See Also