CPropertySheet::SetWizardButtons

更新 : 2007 年 11 月

ウィザード プロパティ シートの [戻る]、[次へ] または [完了] ボタンを有効、無効にします。

void SetWizardButtons(
   DWORD dwFlags 
);

パラメータ

  • dwFlags
    ウィザード ボタンの機能や外観をカスタマイズするフラグの組。このパラメータには、次の値を組み合わせて指定できます。

    • PSWIZB_BACK   [戻る] ボタン。

    • PSWIZB_NEXT   [次へ] ボタン。

    • PSWIZB_FINISH   [完了] ボタン。

    • PSWIZB_DISABLEDFINISH   [完了] ボタンを無効にします。

解説

SetWizardButtons は、ダイアログが開かれた後にだけ呼び出します。DoModal を呼び出す前に SetWizardButtons を呼び出すことはできません。通常、CPropertyPage::OnSetActive から SetWizardButtons を呼び出す必要があります。

ユーザーがウィザードを完了したとき、[完了] ボタンのテキストを変更したり、[戻る] と [次へ] ボタンを非表示にしたりするには、SetFinishText を呼び出します。[完了] と [次へ] では、同一のボタンが共有されます。[完了] と [次へ] ボタンはどちらか一方だけ表示でき、同時に両方は表示できません。

使用例

CPropertySheet には、CStylePage、CColorPage、および CShapePage の 3 つのウィザード プロパティ ページがあります。次のコード片では、ウィザード プロパティ ページの [戻る] ボタンおよび [次へ] ボタンを有効または無効にする方法を示しています。

// CStylePage is the first wizard property page.  Disable the Back 
// button but enable the Next button.
BOOL CStylePage::OnSetActive() 
{
   CPropertySheet* psheet = (CPropertySheet*) GetParent();   
   psheet->SetWizardButtons(PSWIZB_NEXT);

   return CPropertyPage::OnSetActive();
}
// CColorPage is the second wizard property page. Enable both the 
// Back button and the Next button.
BOOL CColorPage::OnSetActive() 
{
   CPropertySheet* psheet = (CPropertySheet*) GetParent();   
   psheet->SetWizardButtons(PSWIZB_BACK | PSWIZB_NEXT);

   return CPropertyPage::OnSetActive();
}
// CShapePage is the last wizard property page. Enable the Back 
// button and change the Next button to Finish. The "Finish" button 
// will have "Done" as its caption.
BOOL CShapePage::OnSetActive() 
{
   CPropertySheet* psheet = (CPropertySheet*) GetParent();   
   psheet->SetWizardButtons(PSWIZB_BACK | PSWIZB_FINISH);
   psheet->SetFinishText(_T("Done"));

   return CPropertyPage::OnSetActive();
}

必要条件

ヘッダー : afxdlgs.h

参照

参照

CPropertySheet クラス

階層図

その他の技術情報

CPropertySheet のメンバ