Adds a new page to the end of an existing property sheet. You can send this message explicitly or by using the PropSheet_AddPage macro.



Must be zero.


Handle to the page to add. The page must have been created by a previous call to the CreatePropertySheetPage function.

Return value

Returns TRUE if successful, or FALSE otherwise.


The new page should be no larger than the largest page currently in the property sheet because the property sheet is not resized to fit the new page.

A number of messages and one function call occur while the property sheet is manipulating the list of pages. While this action is taking place, attempting to modify the list of pages will have unpredictable results. Accordingly, you should not use the PSM_ADDPAGE message in your implementation of PropSheetPageProc or while handling the following notifications and Windows messages.

If you need to modify a property sheet page while you are handling one of these messages or while PropSheetPageProc is in operation, post yourself a private Windows message. Your application will not receive that message until after the property sheet manager has finished its tasks. Then you can modify the list of pages.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]