PSN_APPLY
This message indicates that the user chose the OK or Apply Now button and wants all changes to take effect. It is sent in the form of a WM_NOTIFY message.
PSN_APPLY lppsn = (LPPSHNOTIFY) lParam;
Parameters
- lppsn
Long pointer to a PSHNOTIFY structure that contains information about the notification.
Return Values
Returns the PSNRET_INVALID_NOCHANGEPAGE value to prevent the changes from taking effect and to return the focus to the page, or the PSNRET_NOERROR value to accept the changes and allow the property sheet to be destroyed.
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.
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.
A page should not call the EndDialog function when processing this message.
The property sheet is destroyed if the user clicks the OK button and the application returns the PSNRET_NOERROR value in response to this notification.
To receive this notification, a page must set the DWL_MSGRESULT value to FALSE in response the PSN_KILLACTIVE message.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Prsht.h.
See Also
EndDialog | SetWindowLong | PSN_KILLACTIVE | WM_NOTIFY | NMHDR
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.