PropSheet_SetWizButtons マクロ (prsht.h)

  • [アーティクル]

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

構文

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

パラメーター

hDlg

種類: HWND

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

dwFlags

型: DWORD

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

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

戻り値

なし

解説

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー prsht.h