次の方法で共有

PropSheet_AddPage マクロ (prsht.h)

  • [アーティクル]

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

構文

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

パラメーター

hDlg

型: HWND

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

hpage

型: HPROPSHEETPAGE

追加するページへのハンドル。 このページは、CreatePropertySheetPage 関数の以前の呼び出しによって作成されている必要があります。

戻り値

型: BOOL

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。

備考

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

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

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

必要条件

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