COleChangeSourceDialog::DoModal

virtual int DoModal( );

Return Value

Completion status for the dialog box. One of the following values:

• IDOK if the dialog box was successfully displayed.
  
  
• IDCANCEL if the user canceled the dialog box.
  
  
• IDABORT if an error occurred. If IDABORT is returned, call the COleDialog::GetLastError member function to get more information about the type of error that occurred. For a listing of possible errors, see the OleUIChangeSource function in OLE 2.01 User Interface Library.

Remarks

Call this function to display the OLE Change Source dialog box.

If you want to initialize the various dialog box controls by setting members of the m_cs structure, you should do this before calling DoModal, but after the dialog object is constructed.

If DoModal returns IDOK, you can call member functions to retrieve user-entered settings or information from the dialog box. The following list names typical query functions:

• GetFileName
  
  
• GetDisplayName
  
  
• GetItemName

COleChangeSourceDialog Overview |  Class Members Hierarchy Chart

See Also   COleChangeSourceDialog::COleChangeSourceDialog