次の方法で共有

PropSheet_SetWizButtons マクロ (prsht.h)

  • [アーティクル]

PSM_SETWIZBUTTONS メッセージを投稿して、ウィザードの [戻る]、[次へ]、[完了] ボタンを有効または無効にします。 このマクロを使用することも、PSM_SETWIZBUTTONS メッセージを明示的に送信することもできます。

構文

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

パラメーター

hDlg

型: HWND

プロパティ シートへのハンドル。

dwFlags

型: DWORD

有効にするウィザード ボタンを指定する値。 次のフラグを 1 つ以上組み合わせることができます。

価値 意味
PSWIZB_BACK
 [戻る] ボタンを有効にします。 このフラグが設定されていない場合、[戻る] ボタンは無効として表示されます。
PSWIZB_DISABLEDFINISH
 無効になっている [完了] ボタンを表示します。
PSWIZB_FINISH
 有効な [完了] ボタンを表示します。
PSWIZB_NEXT
 [次へ] ボタンを有効にします。 このフラグが設定されていない場合、[次へ] ボタンは無効として表示されます。

戻り値

型: VOID

戻り値はありません。

備考

このマクロは、PostMessage を使用して、PSM_SETWIZBUTTONS メッセージを送信します。 通知ハンドラーが PropSheet_SetWizButtonsを呼び出す場合は、ハンドラーが戻るまでウィンドウフォーカスに影響を与えることはありません。 たとえば、PropSheet_SetWizButtonsを呼び出した直後 MessageBox を呼び出すと、メッセージ ボックスにフォーカスが移動します。 PostMessage で送信されたメッセージは、メッセージ キューの先頭に到達するまで配信されないため、PSM_SETWIZBUTTONS メッセージは、ウィザードがメッセージ ボックスにフォーカスを失うまで配信されません。 その結果、プロパティ シートはボタンのフォーカスを適切に設定できません。

ウィザードでは、各ページの下に 3 つまたは 4 つのボタンが表示されます。 このメッセージは、有効にするボタンを指定するために使用されます。 ウィザードでは通常、[戻る]、[キャンセル]、[次へ] または [完了] ボタンが表示されます。 通常は、ウェルカム ページの [次へ] ボタン、内部ページの [次へ] と [戻る] ボタン、完了ページの [戻る] と [完了] のみを有効にします。 [キャンセル] ボタンは常に有効になっています。 通常、PSWIZB_FINISHまたはPSWIZB_DISABLEDFINISHを設定すると、[次へ] ボタンが [完了] ボタンに置き換えられます。 [次へ] ボタンと [完了] ボタンを同時に表示するには、ウィザードの作成時に、ウィザードの PROPSHEETHEADER 構造の dwFlags メンバーにPSH_WIZARDHASFINISHフラグを設定します。 その後、すべてのページに 4 つのボタンがすべて表示されます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー prsht.h