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 |