C++ и Excel

HOWTO: Automate Excel 97/2000 and Then Know the User Closed It

Q192348


--------------------------------------------------------------------------------
The information in this article applies to:

Microsoft Visual Studio 97
Microsoft Visual C++, 32-bit Editions, versions 5.0, 6.0
Microsoft Office 2000 Developer
Microsoft Excel 2000
Microsoft Excel 97 for Windows
The Microsoft Foundation Classes (MFC)

--------------------------------------------------------------------------------


SUMMARY
This article illustrates how to:

Automate Microsoft Excel 97 or Excel 2000 using Microsoft Visual C++ and Microsoft Foundation Classes (MFC).


Wait for the end-user to close that instance of Excel.


Have your VC++ controller know that Excel is closed.





MORE INFORMATION
Microsoft Excel 97 or Excel 2000 do not raise a "Quit" event that can observed by other processes. When an out-of-process application that controls an instance of Excel releases all object references to the instance and tells it to quit, that controller knows Excel has terminated. But, when the controller creates and makes an instance of Excel visible it does not know when the end-user has closed Excel. As long as the controlling application has unreleased object references to the instance, Excel remains loaded and registered in the Running Object Table.

This article uses the concepts of Microsoft Knowledge Base article:



Q178749 HOWTO: Create Automation Project Using MFC and a Type Library
and modifies that article's step 14 to include sample code to illustrate one method of determining that the end-user has actually closed the instance of Excel. The approach is to call WaitForSingleObject() to determine that the specific Excel process has terminated.
Notes for Automating Microsoft Excel 2000
Some methods and properties have changed for Microsoft Excel 2000. For additional information about using the sample code described in this article with the Microsoft Excel 2000 type library, please see the following article in the Microsoft Knowledge Base:


Q224925 INFO: Type Libraries for Office 2000 Have Changed
Create an Automation Project
With Microsoft Developer Studio, start a new "MFC AppWizard (exe)" project named AutoProject.


In step 1 of the MFC AppWizard, choose Dialog Based for the application type and click Finish. The New Project Information dialog box appears and indicates that the Classes to be created include:

Application: CAutoProjectApp in AutoProject.h and AutoProject.cpp
Dialog: CAutoProjectDlg in AutoProject.h and AutoProjectDlg.cpp

Click OK to create the project.


In the project workspace, click the "Resource View" tab. Double-click AutoProject Resources to expand the resource tree. Double-click Dialog in the Resource tree and double-click to select the dialog box resource IDD_AUTOPROJECT_DIALOG.


Remove the Label control (IDC_STATIC).


Change the name of the OK button to IDSEEXLQUIT and the caption to "See Excel Quit." Close the AutoProject.rc dialog box design form.


Click ClassWizard on the View menu (or press CTRL+W).


Select the Message Maps tab. Select IDSEEXLQUIT in the Object Ids list box and select BN_CLICKED in the Messages list box. Click Add Function and accept the function name OnSeexlquit. Click OK to close the ClassWizard.

NOTE: This step adds a declaration for the function member OnSeexlquit(); to the header file named AutoProjectDLG.h. This step also adds an empty skeleton message handler function named CAutoProjectDlg::OnSeexlquit() to the file named AutoProjectDLG.cpp.


Click ClassWizard on the View menu (or press CTRL+W).


Select the Automation tab. Click Add Class and choose "From a type library." Navigate to select the object library for Microsoft Excel 8.0 Object Library; (the default location is C:\Program Files\Microsoft Office\Office\Excel8.olb) and click Open. Select all classes in the Confirm Classes list and click OK. For Excel 2000, select the object library for Microsoft Excel 9.0 Object Library; The default location is C:\Program Files\Microsoft Office\Office\Excel9.ol.

NOTE: The list box in the Confirm Classes dialog box contains all of the IDispatch interfaces in the Microsoft Excel type library. In the lower half of the dialog box you will see that an Implementation file named Excel8.cpp contains generated class wrappers derived from ColeDispatchDriver(), and the appropriate declaration header file is named Excel8.h. For Excel 2000, the implementation file is Excel9.cpp and the declaration header file is Excel9.h.


Click OK to close the MFC ClassWizard dialog box.


Add the following code to the CAutoProjectApp::InitInstance() function, which loads and enables the COM services library:


Add the following line to the #include statements at the top of the AutoProject.cpp program file:



Add the include statement for Excel8.h after the include statement for Stdafx.h at the top of the AutoProjectDlg.cpp program file:



Add automation code to the CAutoProjectDlg::OnSeexlquit() so that it appears as shown below:



Build and run the project. When the dialog box appears, minimize Visual Studio, leaving the dialog box from your project. Click the "See Excel Quit" button. Wait for Excel to appear and be visible. Once it is visible, at your leisure, click the control button at the right end of the title bar (the "X") to close Excel.