PropSheet_CancelToClose マクロ (prsht.h)
最新の PSN_APPLY 通知以降に行われた変更を取り消すことができない場合に使用されます。 PSM_CANCELTOCLOSE メッセージを明示的に送信することもできます。
構文
VOID PropSheet_CancelToClose(
HWND hDlg
);
パラメーター
hDlg
型: HWND
プロパティ シートへのハンドル。
戻り値
型: VOID
戻り値はありません。
備考
PSM_CANCELTOCLOSE、[キャンセル] ボタンを無効にし、[OK] ボタンのテキストを [閉じる] に変更します。 このマクロを使用することも、PSM_CANCELTOCLOSE メッセージを明示的に送信することもできます。
ほとんどのプロパティ シートは、PSN_APPLY 通知が受信されるまで、元に戻せない変更の実行を待機します。 ただし、状況によっては、プロパティ シートによって、標準のPSN_APPLY/PSN_RESET シーケンス以外で元に戻せない変更が行われる場合があります。 たとえば、プロパティを編集するためのサブダイアログ ボックスを表示するために使用する 編集 ボタンを含むプロパティ シートがあります。 ユーザーが [OK] をクリックして変更を送信すると、プロパティ シート ページにはいくつかのオプションがあります。
- 変更を記録できますが、PSN_APPLY 通知を受け取って適用されるまで待ちます。 これが推奨されるアプローチです。
- サブダイアログ ボックスを終了した直後に変更を適用できますが、元の設定を覚えておいてください。 これらの設定は、PSN_RESET 通知を受信した場合に元の状態を復元するために使用できます。
- 変更をすぐに適用でき、PSN_RESET 通知を受け取ったときに元の設定を復元しようとすることはできません。 この方法は推奨されませんが、他の 2 つのオプションを実用的にするには、変更が大きすぎる場合に必要になる場合があります。
注 Aero ウィザード スタイル (PSH_AEROWIZARD) を使用する場合、このマクロはサポートされていません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | prsht.h |