CPropertySheet::SetWizardButtons

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

更新 : 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();
}