Share via

PropSheet_AddPage マクロ (prsht.h)

  • [アーティクル]

既存のプロパティ シートの末尾に新しいページを追加します。 このマクロを使用することも、 PSM_ADDPAGE メッセージを明示的に送信することもできます。

構文

void PropSheet_AddPage(
   hDlg,
   hpage
);

パラメーター

hDlg

種類: HWND

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

hpage

種類: HPROPSHEETPAGE

追加するページを処理します。 ページは、 CreatePropertySheetPage 関数の以前の呼び出しによって作成されている必要があります。

戻り値

なし

解説

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

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

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

要件

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