PSM_SHOWWIZBUTTONS メッセージ

ウィザードのボタンを表示または非表示にします。 このメッセージは、明示的に送信することも、 PropSheet_ShowWizButtons マクロを使用して送信することもできます。

パラメーター

wParam

表示するプロパティ シート ボタンを指定する次の 1 つ以上の値。 このパラメーターと lParam の両方にボタン値が含まれている場合は、それが表示されます。

値	説明
PSWIZB_BACK	[ 戻る ] ボタン。
PSWIZB_CANCEL	[ キャンセル] ボタン。
PSWIZB_DISABLEDFINISH	[完了] ボタン。
PSWIZB_FINISH	[完了] ボタン。
PSWIZB_NEXT	[ 次へ ] ボタン。
PSWIZB_SHOW	lParam で指定されたすべてのボタンを非表示にするには、このフラグ (ゼロとして定義) のみを設定します。
PSWIZB_RESTORE	実装されていません。

lParam

wParam で使用されているのと同じ値の 1 つ以上。この呼び出しの影響を受けるボタンを指定します。 このパラメーターにはボタン値が表示されますが、 wParam には表示されない場合、ボタンは非表示になります。

戻り値

戻り値はありません。

解説

ウィザードでは、各ページの下に 3 つまたは 4 つのボタンが表示されます。 このメッセージは、表示されるボタンを指定するために使用されます。 ウィザードでは通常、[ 戻る] 、[キャンセル]、[ 次へ ] または [完了] ボタンが表示されます。 [ キャンセル] ボタンは常に表示されます。

通常、 PSWIZB_FINISH または PSWIZB_DISABLEDFINISH を設定して、[ 次へ ] ボタンを [完了] ボタンに置き換えます。 [次へ] ボタンと [完了] ボタンを同時に表示するには、ウィザードの作成時に PROPSHEETHEADER 構造体の dwFlags メンバーでPSH_WIZARDHASFINISH フラグを設定します。 その後、すべてのページに[ 戻る]、[ 次へ]、[ キャンセル]、[ 完了] の 4 つのボタンがすべて表示されます。

PropSheet_ShowWizButtons マクロを使用してこのメッセージを送信すると、それが投稿されます。 それ以外の場合は、 SendMessage を使用して PSM_SHOWWIZBUTTONSを送信できます。

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

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	Prsht.h