PropSheet_RemovePage マクロ (prsht.h)

  • [アーティクル]

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

構文

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

パラメーター

hDlg

種類: HWND

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

index

型: int

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

hpage

種類: HPROPSHEETPAGE

削除するページを処理します。

戻り値

なし

解説

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

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

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

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

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

要件

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