PSM_CANCELTOCLOSE メッセージ

キャンセルできない最新の PSN_APPLY 通知以降に変更が実行されたときに、アプリケーションによって送信されます。 このメッセージは、明示的に送信することも、 PropSheet_CancelToClose マクロを使用して送信することもできます。

パラメーター

wParam

ゼロを指定してください。

lParam

ゼロを指定してください。

戻り値

戻り値はありません。

解説

PSM_CANCELTOCLOSE [ キャンセル ] ボタンを無効にし、[ OK] ボタンのテキストを [閉じる] に変更します。

ほとんどのプロパティ シートは、PSN_APPLY通知が受信されるまで、元に戻せない変更の実行を待機します。 ただし、状況によっては、プロパティ シートが標準のPSN_APPLY/PSN_RESET シーケンス外で元に戻せない変更を行う場合があります。 1 つの例は、プロパティを編集するためのサブダイアログ ボックスを表示するために使用される [編集] ボタンを含むプロパティ シートです。 ユーザーが [OK] を クリックして変更を送信すると、プロパティ シート ページにはいくつかのオプションがあります。

• 変更は記録できますが、PSN_APPLY通知を受け取るまで待って適用できます。 これは、推奨されている手法です。
• サブダイアログ ボックスを終了した直後に変更を適用できますが、元の設定を覚えておいてください。 これらの設定は、PSN_RESET通知を受信した場合に元の状態を復元するために使用できます。
• 変更は直ちに適用でき、 PSN_RESET 通知を受信したときに元の設定を復元しようとすることはできません。 この方法は推奨されませんが、他の 2 つのオプションを実用的にするには、変更が遠すぎる場合に必要な場合があります。

3 番目のオプションでは、アプリケーションはプロパティ シート にPSM_CANCELTOCLOSE メッセージを送信する必要があります。 [ キャンセル ] ボタンをクリックすると、サブダイアログ ボックスで行われた変更を元に戻すことができないことをユーザーに示します。

注意

このメッセージは、Aero ウィザード スタイル (PSH_AEROWIZARD) を使用する場合はサポートされていません。

必要条件

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