CPropertyPage::OnKillActive

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ページがアクティブではなくなるときに、フレームワークが呼び出します。

virtual BOOL OnKillActive( );

戻り値

データが更新できた場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

特別なデータの妥当性検査を行うには、このメンバ関数をオーバライドします。

このメンバ関数の既定の実装では、プロパティページのコントロールから、プロパティページのメンバ変数に設定をコピーします。ダイアログデータバリデーション (DDV) のエラーによってデータが更新できなかったときは、ページがフォーカスを保持したままになります。

この関数が正常終了すると、フレームワークは、このページの OnOK 関数を呼び出します。

使用例

// Validate the value entered to the "Number" edit control. Its
// value must be at least one. If not, tell the user and set the
// focus to the "Number" edit control. CStylePage is a 
// CPropertyPage-derived class.
BOOL CStylePage::OnKillActive() 
{
   int num = GetDlgItemInt(IDC_NUMOBJECTS);
   if (num <= 0)
   {
      AfxMessageBox(_T("Number of objects must be at least 1."));
      CEdit* edit = (CEdit*) GetDlgItem(IDC_NUMOBJECTS);
      edit->SetFocus();
      edit->SetSel(0, -1);
      return 0;
   }

   return CPropertyPage::OnKillActive();
}