次の方法で共有


PSM_INSERTPAGE メッセージ

既存のプロパティ シートに新しいページを挿入します。 ページは、指定したインデックスに挿入することも、指定したページの後に挿入することもできます。 このメッセージは、明示的に送信することも、 PropSheet_InsertPage マクロを使用して送信することもできます。

パラメーター

wParam

ページを挿入する場所。 新しいページを最初のページにするには、このパラメーターを NULL に 設定します。 新しいページを挿入する場所を指定するには、インデックスまたは既存のページの HPROPSHEETPAGE ハンドルを渡します。

説明
インデックス
wParam パラメーターが MAXUSHORT (最大符号なし短整数) より小さい場合、wParam は新しいページの 0 から始まるインデックスを指定します。 たとえば、挿入されたページをプロパティ シートの 3 番目のページにするには、 wParam を 2 に設定します。 最初のページにするには、 wParam を 0 に設定します。 wParam の値がページ数より大きく、MAXUSHORT より小さい場合は、ページが追加されます。
hpageInsertAfter
wParam パラメーターを既存のページの HPROPSHEETPAGE ハンドルに設定すると、その後に新しいページが挿入されます。

lParam

挿入するページへのハンドル。 ページは、まず CreatePropertySheetPage 関数の呼び出しによって作成する必要があります。

戻り値

ページが正常に挿入された場合は 0 以外の値を返し、それ以外の場合は 0 を返します。

解説

挿入ポイントの後のページは、新しいページに合わせて右にシフトされます。

プロパティ シートのサイズは、新しいページに合わせて変更されません。 新しいページをプロパティ シートの最大ページより大きくしないでください。

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

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

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

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

Note

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

要件

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