COleInsertDialog::DoModal

更新 : 2007 年 11 月

OLE の [オブジェクトの挿入] ダイアログ ボックスを表示します。

virtual INT_PTR DoModal( );
INT_PTR DoModal(
   DWORD dwFlags 
);

パラメータ

  • dwFlags
    次のいずれかの値を使用します。

    COleInsertDialog::DocObjectOnly では、DocObject のみが挿入されます。

    COleInsertDialog::ControlsOnly では、ActiveX コントロールのみが挿入されます。

    0 にすると、DocObject オブジェクトも ActiveX コントロールも挿入されません。つまり、上記の最初のプロトタイプと同じ実装になります。

戻り値

ダイアログ ボックスの終了ステータスを返します。次のいずれかの値が返されます。

  • IDOK ダイアログ ボックスが正常に表示されたときに返されます。

  • IDCANCEL ダイアログ ボックスがキャンセルされたときに返されます。

  • IDABORT エラーが発生したときに返されます。IDABORT が返されたときは、COleDialog::GetLastError メンバ関数を呼び出して、発生したエラーについての詳しい情報を取得できます。発生する可能性のあるエラーの一覧については、Windows SDK の「OleUIInsertObject」関数を参照してください。

解説

m_io 構造体のメンバを設定してダイアログ ボックスの各コントロールを初期化する場合は、ダイアログ オブジェクトを構築した後、DoModal を呼び出す前に行います。

DoModalIDOK を返したときは、ほかのメンバ関数を呼び出して、ユーザーがダイアログ ボックスに入力した設定や情報を取得できます。

必要条件

ヘッダー : afxodlgs.h

参照

参照

COleInsertDialog クラス

階層図

COleDialog::GetLastError

CDialog::DoModal

COleInsertDialog::GetSelectionType

COleInsertDialog::GetClassID

COleInsertDialog::GetDrawAspect

COleInsertDialog::GetIconicMetafile

COleInsertDialog::GetPathName

COleInsertDialog::m_io

その他の技術情報

COleInsertDialog のメンバ