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
V sadě Microsoft Developer Studio spusťte nový projekt MFC AppWizard (exe) s názvem AutoProject.
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.
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.
Odeberte ovládací prvek Popisek (IDC_STATIC) a tlačítko Zrušit (IDCANCEL).
Změňte název tlačítka OK na IDRUN a titulek na Spustit. Zavřete formulář návrhu dialogového okna AutoProject.rc.
V nabídce Zobrazení klikněte na ClassWizard (nebo stiskněte kombinaci kláves CTRL+W).
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.
V nabídce Zobrazení klikněte na ClassWizard (nebo stiskněte kombinaci kláves CTRL+W).
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.
Kliknutím na tlačítko OK zavřete dialogové okno Průvodce třídou MFC.
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(); . . . }
Do příkazů #include v horní části souboru programu AutoProject.cpp přidejte následující řádek:
#include <afxdisp.h>
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"
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); } }
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); }
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