CPropertyPage::QuerySiblings
更新 : 2007 年 11 月
プロパティ シートの各ページにメッセージを転送します。
LRESULT QuerySiblings(
WPARAM wParam,
LPARAM lParam
);
パラメータ
wParam
メッセージ依存の追加情報を指定します。lParam
メッセージに依存した付加情報。
戻り値
ページからプロパティ シートに 0 以外の値を返します。すべてのページが値 0 を返す場合は 0 を返します。
解説
ページが 0 以外の値を返した場合は、プロパティ シートは以降のページにメッセージを送りません。
使用例
// 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);
}
必要条件
ヘッダー : afxdlgs.h