COleInsertDialog::DoModal

virtual int DoModal( );
int DoModal( DWORD dwFlags );

返回值：
返回对话框的完成状态。可以是下列值之一：

·	IDOK	如果对话框被成功显示。
·	IDCANCEL	如果用户取消了对话框。
·	IDABORT	如果发生了一个错误。如果返回的是IDABORT，调用COleDialog::GetLastError成员函数来获取更多有关所发生的错误的类型的信息。可能发生的错误的列表，参见“OLE 2.01用户接口库”中的OleUIInsertObject。

参数：

dwFlags

是下列值之一： · COleInsertDialog::DocObjectOnly 将只插入DocObjects。 · COleInsertDialog::ControlsOnly 将只插入ActiveX控件。 如果是零，则DoModal将既不插入一个DocObjects，也不插入一个ActiveX控件；它的返回值与上面所列的第一种原形的返回值一样。

说明：
此函数用来显示该OLE Insert Object对话框。
如果你想通过设置m_io结构的成员来初始化不同的对话框控件，你应该在第一DoModal之前，但在对话框对象被构造之后进行。
如果DoModal返回的是IDOK，则你可以调用其它的成员函数来获取用户输入到此对话框中的设置或信息。

请参阅：
COleDialog::GetLastError, CDialog::DoModal, COleInsertDialog::GetSelectionType, COleInsertDialog::GetClassID, COleInsertDialog::GetDrawAspect, COleInsertDialog::GetIconicMetafile, COleInsertDialog::GetPathName, COleInsertDialog::m_io