Click here to Skip to main content
Click here to Skip to main content
Go to top

Using the PSM_QUERYSIBLINGS message

, 17 Jul 2004
Rate this:
Please Sign up or sign in to vote.
Explains how to use the PSM_QUERYSIBLINGS message to share data between pages on a property sheet.

Introduction

The idea for this article came from a query in the VC++ forum. I hope someone does find this useful.

How to use PSM_QUERYSIBLINGS

If you want to know how to use the PSM_QUERYSIBLINGS message to send data between pages on a property sheet, the first step is to look at the CPropertyPage::QuerySiblings function.

LRESULT CPropertyPage::QuerySiblings(WPARAM wParam, LPARAM lParam)
{
   ASSERT(::IsWindow(m_hWnd));
   ASSERT(GetParent() != NULL);

   return GetParent()->SendMessage(PSM_QUERYSIBLINGS, wParam, lParam);
}

You will see all it does is sends a PSM_QUERYSIBLINGS message to the parent CPropertySheet. The property sheet's default behavior is to relay the PSM_QUERYSIBLINGS message to all of its child pages. So for each page, you would set up a message map entry to catch the PSM_QUERYSIBLINGS message, and add the function to handle it.

BEGIN_MESSAGE_MAP(CMyPropertyPage, CPropertyPage)
   ON_MESSAGE(PSM_QUERYSIBLINGS, OnQuerySiblings)
END_MESSAGE_MAP()

...

LRESULT CMyPropertyPage1::OnQuerySiblings(WPARAM wParam, LPARAM lParam)
{
   // Do whatever you want done here. The wParam and lParam
   // parameters will have the values you specified in the
   // call to CPropertyPage::QuerySiblings()

   return 0; // returning anything but 0 stops the PSM_QUERYSIBLINGS
             // message from being sent to any more pages.
}

If you want the property sheet to handle the message, you would set up the sheet's message map to also catch the PSM_QUERYSIBLINGS message. Just be sure to call Default() so that the default handler gets called.

LRESULT CMyPropertySheet::OnQuerySiblings(WPARAM wParam, LPARAM lParam)
{
   // Do what ever you want on the property sheet when the PSM_QUERYSIBLINGS
   // message is being handled. The wParam and lParam parameters will have
   // the values you specified in the call to CPropertyPage::QuerySiblings()

   return Default();
}

If you want to change the wParam and lParam values when your sheet handles the message, and pass the changed values onto the property pages, you will have to send the PSM_QUERYSIBLINGS message to each window yourself.

LRESULT CMyPropertySheet::OnQuerySiblings(WPARAM wParam, LPARAM lParam)
{
   // change the wParam and/or lParam values

   int nPages = GetPageCount();
   LRESULT result = 0;
   for (int page = 0; page < nPages && result == 0; ++page)
      result = GetPage(page)->SendMessage(PSM_QUERYSIBLINGS, wParam, lParam);

   return result;
}

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

PJ Arends
President
Canada Canada
No Biography provided

Comments and Discussions

 
QuestionDynamically added pages don't receive message PinmemberMike Pulice19-Sep-05 13:03 
GeneralRefreshing property pages Pinmembermonimicki30-Nov-04 22:59 
GeneralNote: Transfering CStrings PinmemberColinDavies18-Jul-04 13:40 
GeneralRe: Note: Transfering CStrings PinmemberSteve Mayfield19-Jul-04 12:31 
GeneralRe: Note: Transfering CStrings PinmemberBlake Miller20-Jul-04 4:47 
Generalaltering message parameters PinmemberPaolo Messina18-Jul-04 6:45 
GeneralRe: altering message parameters PinmemberPJ Arends18-Jul-04 9:00 
GeneralBelieve me it is useful. PinmemberColinDavies17-Jul-04 20:28 
GeneralRe: Believe me it is useful. PinmemberPJ Arends17-Jul-04 20:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.140916.1 | Last Updated 18 Jul 2004
Article Copyright 2004 by PJ Arends
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid