COleChangeIconDialog::DoModal

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

virtual INT_PTR 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 OleUIChangeIcon function in the Windows SDK.

Remarks

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

If DoModal returns IDOK, you can call other member functions to retrieve the settings or information that was input by the user into the dialog box.

Requirements

Header: afxodlgs.h

See Also

Reference

COleChangeIconDialog Class

Hierarchy Chart

COleDialog::GetLastError

CDialog::DoModal

COleChangeIconDialog::m_ci

COleChangeIconDialog::DoChangeIcon

COleChangeIconDialog::GetIconicMetafile

Other Resources

COleChangeIconDialog Members