Automatizace aplikace Microsoft Word pro hromadnou korespondenci pomocí jazyka Visual C++ a knihovny MFC

Souhrn

Tento článek ukazuje, jak vytvořit a manipulovat s dokumentem aplikace Microsoft Word pomocí automatizace z Microsoft Visual C++ a Microsoft Foundation Classes (MFC).

Další informace

Tento článek paralelizuje článek znalostní báze Microsoft Knowledge Base, který popisuje stejný proces pomocí jazyka Microsoft Visual Basic.

Vytvoření ukázky automatizace

  1. V sadě Microsoft Developer Studio spusťte nový projekt MFC AppWizard (exe) s názvem AutoProject.

  2. V kroku 1 mfc AppWizard zvolte "Dialog Based" pro typ aplikace a potom klepněte na tlačítko Dokončit.

    Zobrazí se dialogové okno Informace o novém projektu, které označuje, že třídy, které se mají vytvořit, zahrnují:

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

    Kliknutím na tlačítko OK vytvořte projekt.

  3. Dialogové okno IDD_AUTOPROJECT_DIALOG se otevře v oblasti návrhu a úprav sady Visual Studio. Upravte ho podle pokynů v následujících dvou krocích.

  4. Odeberte ovládací prvek Popisek (IDC_STATIC) a tlačítko Zrušit (IDCANCEL).

  5. Změňte název tlačítka OK na IDRUN a titulek na Spustit. Zavřete formulář návrhu dialogového okna AutoProject.rc.

  6. V nabídce Zobrazení klikněte na ClassWizard (nebo stiskněte kombinaci kláves CTRL+W).

  7. Vyberte kartu Mapy zpráv. V seznamu ID objektů vyberte IDRUN a v seznamu Zprávy vyberte "BN_CLICKED". Klikněte na Přidat funkci a přijměte název funkce OnRun. Kliknutím na tlačítko OK zavřete Průvodce třídou.

    POZNÁMKA:** Tento krok přidá deklaraci pro člen funkce "OnRun();" do souboru záhlaví s názvem AutoProjectDLG.h. Tento krok také přidá prázdnou funkci obslužné rutiny zprávy s názvem CAutoProjectDlg::OnRun() do souboru s názvem AutoProjectDLG.cpp.

  8. V nabídce Zobrazení klikněte na ClassWizard (nebo stiskněte kombinaci kláves CTRL+W).

  9. Vyberte kartu Automatizace. Klikněte na Přidat třídu a zvolte Z knihovny typů. Přejděte a vyberte knihovnu objektů pro aplikaci, kterou chcete automatizovat (pokud například automatizujete Excel 97, zvolte knihovnu objektů Microsoft Excelu 8.0. Výchozí umístění je C:\Program Files\Microsoft Office\Office\Excel8.olb).

    Pokud automatizujete aplikaci Microsoft Excel 2000, zvolte Microsoft Excel 9.0 Object Library, pro které je výchozím umístěním C:\Program Files\Microsoft Office\Office\Excel9.olb.

    Pokud automatizujete aplikace Microsoft Excel 2002 a Microsoft Office Excel 2003, je knihovna objektů vložena do Excel.exe souboru. Výchozí umístění pro Excel.exe v Office 2002 je C:\program Files\Microsoft Office\Office10\Excel.exe. Výchozí umístění pro Excel.exe v Office 2003 je C:\program Files\Microsoft Office\Office11\Excel.exe. Jakmile vyberete příslušnou knihovnu objektů, klikněte na otevřít. V seznamu Potvrdit třídy vyberte všechny třídy a klikněte na OK.

    POZNÁMKA Seznam v dialogovém okně Potvrdit třídy obsahuje všechna rozhraní IDispatch (která jsou prakticky identická s třídami) v knihovně typů aplikace Microsoft Excel. V dolní polovině dialogového okna uvidíte, že soubor implementace s názvem Excel8.cpp obsahuje obálky vygenerované třídy odvozené z ColeDispatchDriver() a příslušný soubor hlaviček deklarace má název Excel8.h. (V excelu 2002 a Excelu 2003 mají soubory název Excel.cpp a Excel.h.)

    Poznámka Zvolte správnou knihovnu typů pro verzi Wordu, kterou automatizujete. Informace o vyhledání správné knihovny typů najdete v části odkazy níže.

  10. Kliknutím na tlačítko OK zavřete dialogové okno Průvodce třídou MFC.

  11. Do funkce CAutoProjectApp::InitInstance() přidejte následující kód, který načte a povolí knihovnu služeb COM:

    BOOL CAutoProjectApp::InitInstance()
      {
         if(!AfxOleInit())  // Your addition starts here
         {
            AfxMessageBox("Could not initialize COM dll");
            return FALSE;
         }                 // End of your addition
    
         AfxEnableControlContainer();
      .
      .
      .
    
      }
    
  12. Do příkazů #include v horní části souboru programu AutoProject.cpp přidejte následující řádek:

      #include <afxdisp.h>
    
  13. Přidejte příkaz include pro soubor záhlaví, který byl vytvořen výše (msword8.h, msword9.h nebo msword.h) v Souboru AutoProjectDlg.cpp za příkaz include pro stdafx.h. Příklad pro Word 97:

       #include "stdafx.h"
       #include "msword8.h"
    
    
  14. Přidejte kód automation do metody CAutoProjectDlg::OnRun tak, aby se zobrazil, jak je znázorněno níže:

    void CAutoProjectDlg::OnRun()
    {
    _Application oWord;
    Documents oDocs;
    _Document oDoc;
    Selection oSelection;
    Paragraphs oParagraphs;
    Tables oTables;
    Table oTable;
    Range oRange;
    Columns oColumns;
    Column oColumn;
    Rows oRows;
    Row oRow;
    
    Cells oCells;
    Cell oCell; 
    Shading oShading;
    Hyperlinks oHyperlinks;
    MailMerge oMailMerge;
    MailMergeFields oMailMergeFields;
    COleVariant vtOptional((long)DISP_E_PARAMNOTFOUND,VT_ERROR),
            vtTrue((short)TRUE),
    vtFalse((short)FALSE);
    CString StrToAdd;
    
    // Create an instance of Word
    if (!oWord.CreateDispatch("Word.Application")) {
    AfxMessageBox("Word failed to start!");
    } else {
    // Set the visible property
    oWord.SetVisible(TRUE);
    // Add a new document
    oDocs = oWord.GetDocuments();
    oDoc = oDocs.Add(vtOptional,vtOptional);
    
    CreateMailMergeDataFile(&oWord,&oDoc);
    // Add the address header
    
    StrToAdd = "State University\r\nElectrical Engineering " \ 
           "Department";
    oSelection = oWord.GetSelection();
    
    oParagraphs = oSelection.GetParagraphs();
    oParagraphs.SetAlignment(1);  // 1 = wdAlignParagraphCenter  
    oSelection.TypeText(StrToAdd);
    
    InsertLines(&oSelection,4);
    
    oParagraphs.SetAlignment(0);  // 0 = wdAlignParagraphLeft
    oMailMerge = oDoc.GetMailMerge();
    oMailMergeFields = oMailMerge.GetFields();
    oMailMergeFields.Add(oSelection.GetRange(),"FirstName");
    oSelection.TypeText(" ");
    oMailMergeFields.Add(oSelection.GetRange(),"LastName");
    oSelection.TypeParagraph();
    oMailMergeFields.Add(oSelection.GetRange(),"Address");
    oSelection.TypeParagraph();
    oMailMergeFields.Add(oSelection.GetRange(),"CityStateZip");
    
    InsertLines(&oSelection,4);
    // Set the paragraph alignment to Right justified
    oParagraphs = oSelection.GetParagraphs();
    
    oParagraphs.SetAlignment(2);  // 2 = wdAlignParagraphRight
    // Insert the current date
    oSelection.InsertDateTime(COleVariant("dddd, MMMM dd, yyyy"),\ 
     vtFalse,vtOptional);
    
    InsertLines(&oSelection,2);
    
    // Reset the justification to Justify
    
    oParagraphs = oSelection.GetParagraphs();
    oParagraphs.SetAlignment(3);  // 3 = wdAlignParagraphJustify
    
    oSelection.TypeText("Dear ");
    oMailMergeFields.Add(oSelection.GetRange(),"FirstName");
    oSelection.TypeText(",");
    
    InsertLines(&oSelection,2);
    
    // Add the body of the message
    StrToAdd = "Thank you for your recent request for next " \ 
           "semester's class schedule for the Electrical " \ 
           "Engineering Department.  Enclosed with this letter " \ 
           "is a booklet containing all the classes offered " \ 
           "next semester at State University.  Several new " \ 
           "classes will be offered in the Electrical " \ 
              "Engineering Department next semester.  These " \ 
           "classes are listed below.";
    oSelection.TypeText(StrToAdd);
    
    InsertLines(&oSelection,2);
    
    // Add a new table with 9 rows and 4 columns
    oRange = oSelection.GetRange();
    oTables = oDoc.GetTables();
    oTable = oTables.Add(oRange,9,4);
    
    // Set the width of each column
    oColumns = oTable.GetColumns();
    oColumn = oColumns.Item(1);
    oColumn.SetWidth(51.0,0);  // 0 = wdAdjustNone
    oColumn = oColumns.Item(2);
    oColumn.SetWidth(198.0,0);  // 0 = wdAdjustNone
    oColumn = oColumns.Item(3);
    oColumn.SetWidth(100.0,0);  // 0 = wdAdjustNone
    oColumn = oColumns.Item(4);
    oColumn.SetWidth(111.0,0);  // 0 = wdAdjustNone
    
    // Set the shading for row 1 to wdGray25
    oRows = oTable.GetRows();
    oRow = oRows.Item(1);
    oCells = oRow.GetCells();
    oShading = oCells.GetShading();
    oShading.SetBackgroundPatternColorIndex(16); // 16 = wdGray25
    
    // Turn on BOLD for the first row
    oRange = oRow.GetRange();
    oRange.SetBold(TRUE);
    
    // Set the alignment for cell (1,1) to center
    oCell = oTable.Cell(1,1);
    oRange = oCell.GetRange();
    oParagraphs = oRange.GetParagraphs();
    oParagraphs.SetAlignment(1);  // 1 = wdAlignParagraphCenter
    
    // Fill in the class schedule data
    FillRow(&oTable,1,"Class Number","Class Name",\ 
    "Class Time","Instructor");
    FillRow(&oTable,2, "EE220", "Introduction to Electronics II", \ 
    "1:00-2:00 M,W,F", "Dr. Jensen");
    FillRow(&oTable,3, "EE230", "Electromagnetic Field Theory I", \ 
    "10:00-11:30 T,T", "Dr. Crump");
    FillRow(&oTable,4, "EE300", "Feedback Control Systems", \ 
    "9:00-10:00 M,W,F", "Dr. Murdy");
    FillRow(&oTable,5, "EE325", "Advanced Digital Design", \ 
    "9:00-10:30 T,T", "Dr. Alley");
    FillRow(&oTable,6, "EE350", "Advanced Communication Systems", \ 
    "9:00-10:30 T,T", "Dr. Taylor");
    FillRow(&oTable,7, "EE400", "Advanced Microwave Theory", \ 
    "1:00-2:30 T,T", "Dr. Lee");
    FillRow(&oTable,8, "EE450", "Plasma Theory", \ 
    "1:00-2:00 M,W,F", "Dr. Davis");
    FillRow(&oTable,9, "EE500", "Principles of VLSI Design", \ 
    "3:00-4:00 M,W,F", "Dr. Ellison");
    
    // Go to the end of the document
    oSelection.GoTo(COleVariant((short)3), // 3 = wdGoToLine
    COleVariant((short)-1),vtOptional,vtOptional);  // -1 = wdGoToLast
    
    InsertLines(&oSelection,2);
    
    // Add closing text
    StrToAdd = "For additional information regarding the " \ 
                 "Department of Electrical Engineering, " \ 
                 "you can visit our website at ";
    oSelection.TypeText(StrToAdd);
    
    // Add a hyperlink to the homepage
    oHyperlinks = oSelection.GetHyperlinks();
    oHyperlinks.Add(oSelection.GetRange(),\ 
    COleVariant("http://www.ee.stateu.tld"),vtOptional);
    
    // Finish adding closing text
    StrToAdd = ".  Thank you for your interest in the classes " \ 
                 "offered in the Department of Electrical " \ 
                 "Engineering.  If you have any other questions, " \ 
                 "please feel free to give us a call at (999) " \ 
                 "555-1212.\r\n\r\n" \ 
                 "Sincerely,\r\n\r\n" \ 
                 "Kathryn M. Hinsch\r\n" \ 
                 "Department of Electrical Engineering\r\n";
    oSelection.TypeText(StrToAdd);
    
    // Perform mail merge
    oMailMerge.SetDestination(0); // 0 = wdSendToNewDocument
    oMailMerge.Execute(vtFalse);
    
    // Close the original form document
    oDoc.SetSaved(TRUE);
    oDoc.Close(vtFalse,vtOptional,vtOptional);
    
    }
    }
    
    
  15. Do kódu, který je uveden v kroku 3, vložte následující kód výše:

    void InsertLines(Selection *pSelection, int NumLines)
    {
    int iCount;
    
    // Insert NumLines blank lines
    for (iCount = 1; iCount <= NumLines; iCount++)
    pSelection->TypeParagraph();
    }
    
    void FillRow(Table *pTable,int Row, CString Text1, 
     CString Text2, CString Text3, CString Text4)
    {
    Cell oCell;
    Range oRange;
    
    // Insert data into the specific cell
    oCell = pTable->Cell(Row,1);
    oRange = oCell.GetRange();
    oRange.InsertAfter(Text1);
    oCell = pTable->Cell(Row,2);
    oRange = oCell.GetRange();
    oRange.InsertAfter(Text2);
    oCell = pTable->Cell(Row,3);
    oRange = oCell.GetRange();
    oRange.InsertAfter(Text3);
    oCell = pTable->Cell(Row,4);
    oRange = oCell.GetRange();
    oRange.InsertAfter(Text4);
    
    }
    
    void CreateMailMergeDataFile(_Application *pApp,_Document *pDoc)
    {
      _Document oDataDoc;
      MailMerge oMailMerge;
      Documents oDocs;
      Tables oTables;
      Table oTable;
      Rows oRows;
      int iCount;
      COleVariant vtOptional((long)DISP_E_PARAMNOTFOUND,VT_ERROR),
    vtFalse((short)FALSE);
    
    // Create a data source at C:\DataDoc.doc containing the field data
      oMailMerge = pDoc->GetMailMerge();
      oMailMerge.CreateDataSource(COleVariant("C:\\DataDoc.doc"), \ 
            vtOptional,vtOptional, \ 
            COleVariant("FirstName, LastName, Address,CityStateZip"),\ 
            vtOptional, vtOptional,vtOptional,vtOptional,vtOptional);
      // Open the file to insert data
      oDocs = pApp->GetDocuments();
      oDataDoc = oDocs.Open(COleVariant("C:\\DataDoc.doc"), \ 
           vtOptional,vtOptional,vtOptional,vtOptional,\ 
           vtOptional,vtOptional,vtOptional,vtOptional,\ 
           vtOptional);
      oTables = oDataDoc.GetTables();
      oTable = oTables.Item(1);
      oRows = oTable.GetRows();
      for (iCount=1; iCount<=2; iCount++)  
        oRows.Add(vtOptional);
    
    // Fill in the data
      FillRow(&oTable, 2, "Steve", "DeBroux", \ 
            "4567 Main Street", "Buffalo, NY  98052");
      FillRow(&oTable, 3, "Jan", "Miksovsky", \ 
            "1234 5th Street", "Charlotte, NC  98765");
      FillRow(&oTable, 4, "Brian", "Valentine", \ 
            "12348 78th Street  Apt. 214", "Lubbock, TX  25874");
      // Save and close the file
      oDataDoc.Save();
      oDataDoc.Close(vtFalse,vtOptional,vtOptional);
    }
    
    
  16. Zkompilujte a spusťte program. Klikněte na tlačítko Spustit a Microsoft Word by se měl spustit a zobrazit vzorové písmeno. Všimněte si, že se v aplikacích Word 2000 a Word 2002 změnily některé metody. Další informace o těchto změnách naleznete v části "Odkazy".

Odkazy

Poznámky k automatizaci aplikací Microsoft Word 2000 a Microsoft Word 2002

U aplikací Microsoft Word 2000 a Microsoft Word 2002 došlo ke změně některých metod a vlastností.

Další informace o službě Office Automation najdete na webu podpory pro vývoj pro Microsoft Office na adrese: podpora Microsoftu