PropSheet_RemovePage マクロ (prsht.h)

プロパティ シートからページを削除します。 このマクロを使用することも、PSM_REMOVEPAGE メッセージを明示的に送信することもできます。

構文

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

パラメーター

hDlg

型: HWND

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

index

型: int

削除するページの 0 から始まるインデックス。

hpage

型: HPROPSHEETPAGE

削除するページへのハンドル。

戻り値

型: VOID

戻り値はありません。

備考

アプリケーションは、インデックス または hpageに値を割り当てることで、削除するページ 指定できます。 インデックス と hpageの両方に値が割り当てられている場合は、hpage が優先されます。

プロパティ シートがページの一覧を操作している間に、多数のメッセージと 1 つの関数呼び出しが発生します。 このアクションが実行されている間、ページの一覧を変更しようとすると、予期しない結果が発生します。 したがって、PropSheetPageProc の実装で、または次の通知と Windows メッセージを処理するときに、PropSheet_RemovePage マクロを使用しないでください。

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

これらのメッセージのいずれかを処理している間、または PropSheetPageProc の実行中にプロパティ シート ページ 変更する必要がある場合は、プライベート Windows メッセージを自分で投稿します。 プロパティ シート マネージャーがタスクを完了するまで、アプリケーションはそのメッセージを受け取りません。 その後、ページの一覧を変更できます。

次の通知は、プロパティ シートの変更の影響も受けます。

• PSN_WIZBACK
• PSN_WIZNEXT

必要な新しいページを指定するために 0 以外の値を (DWL_MSGRESULT経由で) 返す場合は、これらの通知に応答してページを追加または削除できます。 ただし、現在のページの前にあるページ (現在のページよりも小さいインデックスを持つページ) を削除すると、PSN_KILLACTIVE が間違ったページに送信される可能性があることに注意してください。

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

 

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	prsht.h