PSM_SETWIZBUTTONS メッセージ

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

パラメーター

wParam

このパラメーターを PSWIZBF_ELEVATIONREQUIRED に設定すると、 lParam で指定されたボタンに管理者特権のアイコンが表示されます。 管理者特権のアイコン (または UAC シールド アイコン) は、昇格プロンプトを使用して、ユーザーに承認または資格情報の入力を求めるメッセージを表示することを示します。 詳細については、「 Windows Vista 用 UAC アプリケーションの設計」を参照してください。

注意

UAC シールド アイコンの表示は、AeroWizards (PSH_AEROWIZARD) でのみサポートされています。

lParam

有効にするプロパティ シート ボタンを指定する値。 次のフラグを 1 つ以上組み合わせることができます。

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

戻り値

戻り値はありません。

解説

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

PSN_SETACTIVE 通知の 処理中にPSM_SETWIZBUTTONS メッセージを送信する場合は、 SendMessage 関数ではなく PostMessage 関数を使用します。 それ以外の場合、システムはボタンを正しく更新しません。 PropSheet_SetWizButtons マクロを使用してこのメッセージを送信すると、それが投稿されます。 それ以外の場合は、 SendMessage を使用して PSM_SETWIZBUTTONSを送信できます。

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

必要条件

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