CPropertySheet::DoModal

[アーティクル]
08/09/2011

モーダルプロパティシートを表示します。

virtual INT_PTR DoModal();

戻り値

正常終了した場合は IDOK または IDCANCEL を返します。それ以外の場合は 0 または -1 を返します。プロパティシートがウィザード (「SetWizardMode」を参照) として確立された場合は、DoModal は ID_WIZFINISH または IDCANCEL のどちらかを返します。

解説

戻り値は、プロパティシートを閉じるときに使ったコントロールの ID に対応します。この関数から戻ると、プロパティシートのウィンドウやすべてのページは破棄されます。オブジェクト自身は存在したままです。通常、DoModal が IDOK を返したときは、CPropertyPage オブジェクトからデータを取得します。

モードレスプロパティシートを表示するには、Create を呼び出します。

対応するダイアログリソースからプロパティページが作成されるとき、初回例外が発生する可能性があります。これは、プロパティページによって、ページの作成前にダイアログリソースのスタイルが必要なスタイルに変更されるためです。通常、リソースは書き込み禁止であるため、例外が発生する可能性があります。システムはこの例外を処理し、更新されたリソースのコピーを作成します。このような処理により、初回例外は無視できるようになります。

注意

非同期例外処理モデルを使ってコンパイルする場合、この例外はオペレーティングシステムで処理する必要があります。例外処理モデルの詳細については、「/EH (例外処理モデル)」を参照してください。この場合、CPropertySheet::DoModal の呼び出しを catch (...) のような C++ の try-catch ブロックで囲まないでください。catch はすべての例外を処理します。このブロックによってオペレーティングシステムが処理しようとしている例外も取り扱うことになり、予期しない動作になります。 C++ 例外処理ハンドラーを特定の例外タイプで使用するか、またはアクセス違反例外がオペレーティングシステムに渡される構造化例外処理を使用すると安全です。

初回例外が生成されないようにするには、プロパティシートに正しいウィンドウスタイルを手動で指定します。プロパティシートに対して次のスタイルを設定する必要があります。