Condividi tramite


CPropertyPage::QuerySiblings

Chiamare la funzione membro per inviare un messaggio a ciascuna pagina nella finestra delle proprietà.

LRESULT QuerySiblings(
   WPARAM wParam,
   LPARAM lParam 
);

Parametri

  • wParam
    Specifica le informazioni messaggio-dipendenti aggiuntive.

  • lParam
    Specifica le informazioni messaggio-dipendenti aggiuntive

Valore restituito

Il valore diverso da zero da una pagina nella finestra delle proprietà, oppure 0 se tutte le pagine restituiscono un valore di 0.

Note

Se una pagina restituisce un valore diverso da zero, la finestra delle proprietà non invia il messaggio alle pagine successive.

Esempio

// Validate the value entered in the Number edit control. If its 
// value is not a natural number, request CPropertySheet (i.e. parent
// window of the page) to send a PSM_QUERYSIBLINGS message to each
// LOADED page (a page won't be loaded in memory until it is shown).
// If one of the pages returns a nonzero value in response to the 
// PSM_QUERYSIBLINGS message, then inform the user and change the OK
// to Close and disable the Cancel button. CStylePage is a 
// CPropertyPage-derived class.
BOOL CStylePage::OnApply()
{
   int num = GetDlgItemInt(IDC_NUMOBJECTS);
   if (num <= 0)
   {
      if (QuerySiblings(num, 0L))
      {
         AfxMessageBox(_T("Invalid data is entered.  Choose Close ")
            _T("button to close the dialog."));
         CancelToClose();
      }
   }

   return CPropertyPage::OnApply();
}
// This is an example of trapping the PSM_QUERYSIBLINGS in one of
// the pages. CColorPage is a CPropertyPage-derived class.  Upon 
// receiving this message, wParam contains the value passed to 
// QuerySiblings() call. CColorPage will check this value and return
// FALSE only if the value is greater than 1.
ON_MESSAGE(PSM_QUERYSIBLINGS, &CColorPage::OnQuerySiblings)
LRESULT CColorPage::OnQuerySiblings(WPARAM wParam, LPARAM lParam)
{
   UNREFERENCED_PARAMETER(lParam);
   return (wParam <= 0);
}

Requisiti

Header: afxdlgs.h

Vedere anche

Riferimenti

Classe di CPropertyPage

Grafico della gerarchia