c# word文檔的操作

參考https://blog.csdn.net/ruby97/article/details/7406806

Word對象模型  （.Net Perspective）

本文主要針對在Visual Studio中使用C# 開發關於Word的應用程序

來源：Understandingthe Word Object Model from a .NET Developer's Perspective

五大對象

Application           ：代表Microsoft Word應用程序本身

Document            ：代表一個Word文檔

Selection              ：代表當前選中的區域(高亮)，沒有選中區域時代表光標點

Bookmarks           ：書簽

Range                  ：代表一塊區域，與Selection類似，不過一般不可見

 

下面看一下Word的對象結構圖：

OK,下面是對上述幾大對象的基本特性的描述，讓我們對它們有一些基本的認識。

 

Application是Document和Selection的基類。通過Application的屬性和方法，我們可以控制Word的大環境。

 

 Document代表一個Word文檔，當你新建一個Word文檔或者打開一個已有的Word文檔，你將創建一個Document對象，該對象被加入到Words Documents Collection中。擁有焦點的Document稱為ActiveDocument，可以通過Application對象的ActiveDocument屬性獲得當前文檔對象

 

Selection代表當前選中的區域，它通常是高亮顯示的（例如，你要改變一段文字的字體，你首先得選    中這段文字，那么選中的這塊區域就是當前文檔的Selection對象所包含的區域）

 

Range對象也代表文檔中的一塊區域，它具有以下特點

 

•   包含一個起始位置和一個結束位置
•   它可以包含光標點，一段文本或者整個文檔
•   它包含空格，tab以及paragraph marks
•   它可以是當前選中的區域，當然也可以不是當前選中區域
•   它被動態創建
•   當你在一個Range的末尾插入文本，這將擴展該Range

 

Bookmark對象也代表一塊區域，一般使用Bookmark來標記文檔中的位置，它有如下特點 

•   書簽一般有名字
•   Saved with the document,且文檔關閉了之后書簽繼續存在
•   書簽通常是隱藏的，但也可以通過代碼設置其為可見

 

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

下面分別介紹5大對象：

1. The Application Object

通過Application對象，你可以訪問Word的所有對象以及Collections。

參考更多：MSDN-Word2007-Application Object

1.1      Application對象的屬性（只介紹部分，完整內容請參看MSDN）

l  ActiveWindow    返回一個Window對象表示擁有焦點的窗口

 

// C#
public void CreateNewWindowAndTile()
{
   // Create a new window from the active document.
   Word.Window wnd = ThisApplication.ActiveWindow.NewWindow();
 
   // Tile the two windows.
   Object value = Word.WdArrangeStyle.wdTiled;
   ThisApplication.Windows.Arrange(ref value);
}

 

 

tips:   The Arrange method, like many methods in Word,requires C# developers to pass one or more parameters using the "ref"keyword. This means that the parameter you pass must be stored in a variablebefore you can pass it to the method.

        In every case, you'll need to create an Object variable, assign the variable thevalue you'd like to pass to the method, and pass the variable using the ref keyword. You'll find many examples of this technique throughout this document.

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

l  ActiveDocument        當前活動文檔對象

 

l  ActivePrinter             當前活動打印機

 

l  ActiveWindow           當前活動窗口

 

l  Caption                     文檔標題

// C#設置word文檔標題
public void SetApplicationCaption() 
{
    // Change caption in title bar.
    ThisApplication.Caption = "My New Caption";
}

　　

l  CapsLock   返回大小寫鎖定鍵狀態

// C#
public void CapsLockOn() 
{
    MessageBox.Show(ThisApplication.CapsLock.ToString());
}

　　 

l  DisplayAlerts 用於設置在代碼允許時如何處理警告，它有三種選項:       

1.wdAlertsAll                                顯示所有消息和警告（默認）

2.wdAlertsMessageBox                 僅顯示消息框

3.wdAlertsNone                             忽略任何警告

下面是該屬性的常見用法：

1.  
   // C#
2.  
   public void DisplayAlerts()
3.  
   {
4.  
   // Turn off display of messages and alerts.
5.  
   try
6.  
   {
7.  
   ThisApplication.DisplayAlerts = Word.WdAlertLevel.wdAlertsNone;
8.  
   // Your code runs here without any alerts.
9.  
   // . . .code doing something here.
10.  
     
11.  
    }
12.  
    catch (Exception ex)
13.  
    {
14.  
    // Do something with your exception.
15.  
     
16.  
    }
17.  
    finally
18.  
    {
19.  
    // Turn alerts on again when done.
20.  
    ThisApplication.DisplayAlerts = Word.WdAlertLevel.wdAlertsAll;
21.  
    }
22.  
    }

 

 

l  DisplayStatusBar      可以讀/寫；用於表示是否顯示狀態欄

1.  
   // C#
2.  
   public void ToggleStatusBar()
3.  
   {
4.  
   // Toggle display of the status bar.
5.  
   bool bln = ThisApplication.DisplayStatusBar;
6.  
   ThisApplication.DisplayStatusBar = !bln;
7.  
   }

 

l  Path           返回當前應用程序的路徑

1.  
   // C#
2.  
   MessageBox.Show(ThisApplication.Path);

 

l  Selection    只讀對象，表示當前選擇的區域(也可以表示光標點位置)

 

l  UserName  讀或寫用戶名

1.  
   // C#
2.  
   public void ChangeUserName()
3.  
   {
4.  
   string str = ThisApplication.UserName;
5.  
   MessageBox.Show(str);
6.  
    
7.  
   // Change UserName.
8.  
   ThisApplication.UserName = "Dudley";
9.  
   MessageBox.Show(ThisApplication.UserName);
10.  
    // Restore original UserName.
11.  
    ThisApplication.UserName = str;
12.  
    }

l  Visible        只有為true時才可見

1.  
   // C#
2.  
   try
3.  
   {
4.  
   ThisApplication.Visible = false;
5.  
   // Do whatever it is, invisibly.
6.  
   }
7.  
   catch (Exception ex)
8.  
   {
9.  
   // Your exception handler here.
10.  
    }
11.  
    finally
12.  
    {
13.  
    ThisApplication.Visible = true;
14.  
    }

 

1.2      Application對象的方法

 

l  CheckSpelling 檢查拼寫

 

l  Help 彈出幫助對話框，有三種:WdHelp,WdHelpAbout,WdHelpSearch

1.  
   // C#
2.  
   public void DisplayHelpAbout()
3.  
   {
4.  
   Object value = Word.WdHelpType.wdHelpAbout;
5.  
   ThisApplication.Help( ref value);
6.  
   }

 

l  Move         移動窗口

l  Resize        改變窗口大小

1.  
   // C#
2.  
   public void MoveAndResizeWindow()
3.  
   {
4.  
   // None of this will work if the window is
5.  
   // maximized or minimized.
6.  
   ThisApplication.ActiveWindow.WindowState =
7.  
   Word.WdWindowState.wdWindowStateNormal;
8.  
    
9.  
   // Position at upper left corner.
10.  
    ThisApplication.Move( 0, 0);
11.  
     
12.  
    // Size to 300 x 600 points.
13.  
    ThisApplication.Resize( 300, 600);
14.  
    }

 

l  Quit           退出Word，可以帶參數WdSaveOptions：三個可選值分別是：      

1.wdSaveChanges

        2.wdPromptToSaveChanges

        3.wdDoNotSaveChanges

1.  
   // C#
2.  
   // Automatically save changes.
3.  
   Object saveChanges = Word.WdSaveOptions.wdSaveChanges;
4.  
   Object originalFormat = Type.Missing;
5.  
   Object routeDocument = Type.Missing;
6.  
   ThisApplication.Quit( ref saveChanges,
7.  
   ref originalFormat,
8.  
   ref routeDocument);
9.  
    
10.  
    // Prompt to save changes.
11.  
    saveChanges = Word.WdSaveOptions.wdPromptToSaveChanges;
12.  
    originalFormat = Type.Missing;
13.  
    routeDocument = Type.Missing;
14.  
    ThisApplication.Quit( ref saveChanges,
15.  
    ref originalFormat,
16.  
    ref routeDocument);
17.  
     
18.  
    // Quit without saving changes.
19.  
    saveChanges = Word.WdSaveOptions.wdDoNotSaveChanges;
20.  
    originalFormat = Type.Missing;
21.  
    routeDocument = Type.Missing;
22.  
    ThisApplication.Quit( ref saveChanges,
23.  
    ref originalFormat,
24.  
    ref routeDocument);

 

 

2. The Document Object

     使用Document對象允許你對一個文檔進行操作，同時由於Documents Collection的存在，你可以操作所有已經打開的文檔。

參考更多：MSDN-Word2007-Document Object

2.1        Document Object Collections

一個文檔可以包含一下幾類對象：

 

• l  Characters
• l  Words
• l  Sentences
• l  Paragraphs
• l  Sections
• l  Headers/Footers 

 

2.2 引用文檔

   你可以引用一個Documents Collection中的Document對象。引用的方法是使用索引(1-based)，例如，如下代碼引用了collection中的第一個文檔

1.  
   // C#
2.  
   Word.Document doc = (Word.Document) ThisApplication.Documents[ 1];

當然，你也可以通過文檔的名字來引用它

1.  
   // C#
2.  
   Word.Document doc =
3.  
   (Word.Document) ThisApplication.Documents[ "MyDoc.doc"];

 

2.3        打開，關閉與新建文檔

 

l  Add           新建word文檔  

1.  
   // C#
2.  
   // Create a new document based on Normal.dot.
3.  
   Object template = Type.Missing;
4.  
   Object newTemplate = Type.Missing;
5.  
   Object documentType = Type.Missing;
6.  
   Object visible = Type.Missing;
7.  
    
8.  
   ThisApplication.Documents.Add(
9.  
   ref template, ref newTemplate, ref documentType, ref visible);

 

l  Open 打開word文檔

1.  
   // C#
2.  
   Object filename = @"C:\Test\MyNewDocument";
3.  
   Object confirmConversions = Type.Missing;
4.  
   Object readOnly = Type.Missing;
5.  
   Object addToRecentFiles = Type.Missing;
6.  
   Object passwordDocument = Type.Missing;
7.  
   Object passwordTemplate = Type.Missing;
8.  
   Object revert = Type.Missing;
9.  
   Object writePasswordDocument = Type.Missing;
10.  
    Object writePasswordTemplate = Type.Missing;
11.  
    Object format = Type.Missing;
12.  
    Object encoding = Type.Missing;
13.  
    Object visible = Type.Missing;
14.  
    Object openConflictDocument = Type.Missing;
15.  
    Object openAndRepair = Type.Missing;
16.  
    Object documentDirection = Type.Missing;
17.  
    Object noEncodingDialog = Type.Missing;
18.  
     
19.  
    ThisApplication.Documents.Open( ref filename,
20.  
    ref confirmConversions, ref readOnly, ref addToRecentFiles,
21.  
    ref passwordDocument, ref passwordTemplate, ref revert,
22.  
    ref writePasswordDocument, ref writePasswordTemplate,
23.  
    ref format, ref encoding, ref visible, ref openConflictDocument,
24.  
    ref openAndRepair , ref documentDirection, ref noEncodingDialog);

 

l  Save 保存word文檔

1.  
   // 保存所有文檔
2.  
   Object noPrompt = true;
3.  
   Object originalFormat = Type.Missing;
4.  
   ThisApplication.Documents.Save( ref noPrompt, ref originalFormat);
5.  
    
6.  
   // C#保存當前文檔
7.  
   ThisApplication.ActiveDocument.Save();

 

1.  
   // 保存指定名稱的文檔
2.  
   Object file = "MyNewDocument.doc";
3.  
   ThisApplication.Documents.get_Item( ref file).Save();

 

l  SaveAs 另存為

1.  
   // C#
2.  
   // Save the document. In a real application,
3.  
   // you'd want to test to see if the file
4.  
   // already exists. This will overwrite any previously
5.  
   // existing documents.
6.  
   Object fileName = @"C:\Test\MyNewDocument.doc";
7.  
   Object fileFormat = Type.Missing;
8.  
   Object lockComments = Type.Missing;
9.  
   Object password = Type.Missing;
10.  
    Object addToRecentFiles = Type.Missing;
11.  
    Object writePassword = Type.Missing;
12.  
    Object readOnlyRecommended = Type.Missing;
13.  
    Object embedTrueTypeFonts = Type.Missing;
14.  
    Object saveNativePictureFormat = Type.Missing;
15.  
    Object saveFormsData = Type.Missing;
16.  
    Object saveAsAOCELetter = Type.Missing;
17.  
    Object encoding = Type.Missing;
18.  
    Object insertLineBreaks = Type.Missing;
19.  
    Object allowSubstitutions = Type.Missing;
20.  
    Object lineEnding = Type.Missing;
21.  
    Object addBiDiMarks = Type.Missing;
22.  
     
23.  
    ThisDocument.SaveAs( ref fileName, ref fileFormat, ref lockComments,
24.  
    ref password, ref addToRecentFiles, ref writePassword,
25.  
    ref readOnlyRecommended, ref embedTrueTypeFonts,
26.  
    ref saveNativePictureFormat, ref saveFormsData,
27.  
    ref saveAsAOCELetter, ref encoding, ref insertLineBreaks,
28.  
    ref allowSubstitutions, ref lineEnding, ref addBiDiMarks);

 

 

l  Close 關閉word文檔

1.  
   // 關閉所有文檔
2.  
   Object saveChanges = Word.WdSaveOptions.wdSaveChanges;
3.  
   Object originalFormat = Type.Missing;
4.  
   Object routeDocument = Type.Missing;
5.  
   ThisApplication.Documents.Close( ref saveChanges,
6.  
   ref originalFormat,
7.  
   ref routeDocument);

 

1.  
   // 關閉 active document
2.  
   Object saveChanges = Word.WdSaveOptions.wdDoNotSaveChanges;
3.  
   Object originalFormat = Type.Missing;
4.  
   Object routeDocument = Type.Missing;
5.  
   ThisDocument.Close( ref saveChanges,
6.  
   ref originalFormat,
7.  
   ref routeDocument);
8.  
    
9.  
   // Close MyNewDocument and save changes without prompting.
10.  
    Object name = "MyNewDocument.doc";
11.  
    saveChanges = Word.WdSaveOptions.wdSaveChanges;
12.  
    originalFormat = Type.Missing;
13.  
    routeDocument = Type.Missing;
14.  
     
15.  
    Word.Document doc = ThisApplication.Documents.get_Item( ref name);
16.  
    ThisDocument.Close( ref saveChanges,
17.  
    ref originalFormat,
18.  
    ref routeDocument);

 

l  實例：遍歷DocumentsCollection

1.  
   // C#
2.  
   public void SaveUnsavedDocuments()
3.  
   {
4.  
   // Iterate through the Documents collection.
5.  
   string str;
6.  
   StringWriter sw = new StringWriter();
7.  
    
8.  
   foreach (Word.Document doc in ThisApplication.Documents)
9.  
   {
10.  
    if (!doc.Saved )
11.  
    {
12.  
    // Save the document.
13.  
    doc.Save();
14.  
    sw.WriteLine(doc.Name);
15.  
    }
16.  
    }
17.  
     
18.  
    str = sw.ToString();
19.  
    if ( str == string.Empty )
20.  
    {
21.  
    str = "No documents need saving.";
22.  
    }
23.  
    MessageBox.Show(str, "SaveUnsavedDocuments");
24.  
    }

 

3. The Selection Object

 

Selection對象代表當前選擇的area。在word應用程序中，假如你要讓一段字符變成黑體，你必須首先選擇該段文字，然后應用樣式。在代碼中也是同樣的道理，你要首先定義selection的區域然后進行操作。你可以使用Selection對象在文檔中進行選擇，格式化，操作，添加文本等。

Selection對象是始終存在的，如果當前沒有選擇任何東西，那么它代表一個insertion point。因此，在操作Seleciton之前知道它包含的內容是非常重要的。

Tips：    Selection對象與Range對象有很多成員是類似的，它們之間的區別是Selection對象指的是現實在圖形界面的區域，而Range對象代表的區域是不可見的(當然通過調用方法可以使其可見)

 

1.1      Using the Type Property

   Selection的類型有很多。比如，你要對一張表格的一列進行操作，你應該確保該列已經selected，否則會出現運行時錯誤。

可以通過Selection對象的 Type屬性獲取你需要的信息，Type屬性包含一個WdSelectionType的枚舉類型成員。它有如下幾個值：

• wdSelectionBlock
• wdSelectionColumn
• wdSelectionFrame
• wdSelectionInlineShape   表示一幅圖片
• wdSelectionIP                    表示插入點(insertion point)
• wdSelectionNormal          表示選中的文本或者文本和其他對象的組合
• wdNoSelection
• wdSelectionRow
• wdSelectionShape

下面是Type屬性的應用例子

1.  
   // C#
2.  
   public void ShowSelectionType()
3.  
   {
4.  
   string str;
5.  
   switch (ThisApplication.Selection.Type)
6.  
   {
7.  
   case Word.WdSelectionType.wdSelectionBlock:
8.  
   str = "block";
9.  
   break;
10.  
    case Word.WdSelectionType.wdSelectionColumn:
11.  
    str = "column";
12.  
    break;
13.  
    case Word.WdSelectionType.wdSelectionFrame:
14.  
    str = "frame";
15.  
    break;
16.  
    case Word.WdSelectionType.wdSelectionInlineShape:
17.  
    str = "inline shape";
18.  
    break;
19.  
    case Word.WdSelectionType.wdSelectionIP:
20.  
    str = "insertion point";
21.  
    break;
22.  
    case Word.WdSelectionType.wdSelectionNormal:
23.  
    str = "normal text";
24.  
    break;
25.  
    case Word.WdSelectionType.wdNoSelection:
26.  
    str = "no selection";
27.  
    break;
28.  
    case Word.WdSelectionType.wdSelectionRow:
29.  
    str = "row";
30.  
    break;
31.  
    default:
32.  
    str = "(unknown)";
33.  
    break;
34.  
    }
35.  
    MessageBox.Show(str, "ShowSelectionType");
36.  
    }

 

1.2      Navigating and Selecting Text

為了判斷什么被選中了，你也可以采用下面的方法。

 

1.2.1  Home and End Key Method

在使用Word時，我們知道，按下鍵盤的HOME鍵將使光標移動到光標所在行的行首，按下END鍵將使光標移動到行尾。在代碼中，可以使用模擬按鍵的方法將改變selection。請看下面兩個函數：

HomeKey( [Unit] , [Extend] ) : 模擬按下HOME鍵

EndKey( [Unit] , [Extend] )   ：模擬按下END鍵

上面的兩個函數中，參數Unit有一下可選值（wdUnit類型）：

l  Wdline        移動到一行的開始或結束位置(缺省值)

l  WdStory      移動到文檔的開始或結束位置

l  WdColumn  移動到一列的開始或結束位置（僅針對表格）

l  WdRow       移動到一行的開始或結束位置（僅正對表格）

參數Extend的可選值（WdMovementType類型）：

l  WdMove     移動selection

l  WdExtend   擴展selection。舉例說明：考慮一個場景，當前選擇了一行，然后調用HomeKey方法，傳入參數wdStory以及wdExtend,那么該行將不被包含在新selection對象中，同樣的情況如果調用EndKey方法，那么該行將會包含在新selection對象中。

 

下面的示例代碼演示了：移動insertion point到文檔開始出，然后使用EndKey方法選中整個文檔：

1.  
   // C#
2.  
   // Position the insertion point at the beginning
3.  
   // of the document.
4.  
   Object unit = Word.WdUnits.wdStory;
5.  
   Object extend = Word.WdMovementType.wdMove;
6.  
   ThisApplication.Selection.HomeKey( ref unit, ref extend);
7.  
    
8.  
   // Select from the insertion point to the end of the document.
9.  
   unit = Word.WdUnits.wdStory;
10.  
    extend = Word.WdMovementType.wdExtend;
11.  
    ThisApplication.Selection.EndKey( ref unit, ref extend);

 

1.2.2  Arrow Key Method

既然可以模擬HOME,END鍵，那么當然也可以模擬按下方向鍵。Word提供如下四個方法，其中Count參數代表移動多少個Unit。

• MoveLeft([Unit], [Count], [Extend])
• MoveRight([Unit], [Count], [Extend])
• MoveUp([Unit], [Count], [Extend])
• MoveDown([Unit], [Count], [Extend])

其中，Extend參數使用的是與END,HOME相同的枚舉類型變量，它包含兩個可選值：wdMove,wdExtend.

而移動單元（Unit）類型與前面的有所不同，而且針對左右移動和上下移動有所區分。

• 左右移動時對應的單元類型  MoveLeft() MoveRight()
• wdCharacter: 字符（缺省）
• wdWord: 單詞
• wdCell: 單元格（僅對表格）
• wdSentence: 句子

下面的代碼演示了：向左移動插入點三個字符，然后選擇插入點右邊的三個單詞

1.  
   // C#
2.  
   // Move the insertion point left 3 characters.
3.  
   Object unit = Word.WdUnits.wdCharacter;
4.  
   Object count = 3;
5.  
   Object extend = Word.WdMovementType.wdMove;
6.  
   ThisApplication.Selection.MoveLeft( ref unit, ref count,
7.  
   ref extend);
8.  
    
9.  
   // Select the 3 words to the right of the insertion point.
10.  
    unit = Word.WdUnits.wdWord;
11.  
    count = 3;
12.  
    extend = Word.WdMovementType.wdExtend;
13.  
    ThisApplication.Selection.MoveRight( ref unit, ref count,
14.  
    ref extend);

 

• 上下移動時對應的單元類型 MoveUp() MoveDown()
• wdLine            :行 （缺省）
• wdParagraph  :段落
• wdWindow           :窗口
• wdScreen        :屏幕大小

下面的例子演示了使用上述方法先把插入點向上移動一行，然后選擇其后的三個段落。

1.  
   // C#
2.  
   // Move the insertion point up one line.
3.  
   Object unit = Word.WdUnits.wdLine;
4.  
   Object count = 1;
5.  
   Object extend = Word.WdMovementType.wdMove;
6.  
   ThisApplication.Selection.MoveUp( ref unit, ref count, ref extend);
7.  
    
8.  
   // Select the following 3 paragraphs.
9.  
   unit = Word.WdUnits.wdParagraph;
10.  
    count = 3;
11.  
    extend = Word.WdMovementType.wdMove;
12.  
    ThisApplication.Selection.MoveDown( ref unit, ref count,
13.  
    ref extend);

 

3.2.3 Move Method

使用Move方法將改變指定的range或者selection。

下面的例子將使插入點移動到第三個單詞之前

1.  
    
2.  
   // Use the Move method to move 3 words.
3.  
   Obiect unit = Word.WdUnits.wdWord;
4.  
   Object count = 3;
5.  
   ThisApplication.Selection.Move( ref unit, ref count);

 

3.2.4  Inserting Text

最簡單的在文檔中插入文本的方法是使用Selection對象的TypeText方法。TypeText方法的行為由用戶的選擇決定。下面這個例子就使用了一個叫做    overtype 的選項。該選項如果被打開，那么插入字符將導致插入點后面的文本被覆蓋。

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

重要的例子  演示如何插入文本

(若selection類型不是insertion point或者 a block of text ，那么下面的代碼do nothing)

1.  
    
2.  
   public void InsertTextAtSelection()
3.  
   {
4.  
   Word.Selection sln = ThisApplication.Selection;
5.  
    
6.  
   // Make sure overtype is turned off.
7.  
   ThisApplication.Options.Overtype = false;
8.  
    
9.  
   //當前的selection對象是否為插入點
10.  
    //如果是，那么插入一段字符，然后插入段標記
11.  
    if (sln.Type == Word.WdSelectionType.wdSelectionIP )
12.  
    {
13.  
    sln.TypeText( "Inserting at insertion point. ");
14.  
    sln.TypeParagraph(); //插入paragraph mark
15.  
    }
16.  
     
17.  
    //selection對象是否為normal 類型
18.  
    else if (sln.Type == Word.WdSelectionType.wdSelectionNormal )
19.  
    {
20.  
    // 查看ReplaceSelection選項是否開啟
21.  
    //如果開啟，那么摧毀該selection，同時將selection對象修改為插入點類型//且定位到之前的selection區域頭部
22.  
    if ( ThisApplication.Options.ReplaceSelection )
23.  
    {
24.  
    Object direction = Word.WdCollapseDirection.wdCollapseStart;
25.  
    sln.Collapse( ref direction);
26.  
    }
27.  
    //插入文本與段落標記
28.  
    sln.TypeText( "Inserting before a text block. ");
29.  
    sln.TypeParagraph();
30.  
    }
31.  
    else
32.  
    {
33.  
    // Do nothing.
34.  
    }
35.  
    }
36.  
    -----------------------------------------------------------------------

4. The Range Object

Range對象也代表一個區域。與使用Selection相比較，Range的優勢在於

l  執行給定任務需要較少的代碼

l  不需要改變當前文檔的選中區域（donot have to change the       highlighting）

l  Has greater capabilities

 

4.1 定義並選擇一個Range

 下面的代碼新建一個Range對象，並選擇文檔的前7個字符，包括non-printing字符，然后使用Select方法是Range可見（即高亮顯示）。如果不使用Select方法，在Word界面中你將看不到Range對象的區域，但是可以在程序中操作。

1.  
   // C#
2.  
   Object start = 0;
3.  
   Object end = 7;
4.  
   Word.Range rng = ThisDocument.Range( ref start, ref end);
5.  
   rng.Select();

 

1.1.1  Counting Characters

1.  
   // 選擇整個文檔，並顯示字符總數
2.  
   Object start = Type.Missing;
3.  
   Object end = ThisDocument.Characters.Count;
4.  
    
5.  
   Word.Range rng = ThisDocument.Range( ref start, ref end);
6.  
   rng.Select();
7.  
   MessageBox.Show( "Characters: " +
8.  
   ThisDocument.Characters.Count.ToString());

 

1.1.2  Setting Up Ranges

你可以使用Content屬性使Range包含整個文檔內容

1.  
   // C#
2.  
   Word.Range rng = ThisDocument.Content;

下面的例子完成以下功能：

• 新建一個 Range變量
• 檢查文檔中是否至少含有兩個句子
• 使Range的起始點為第二個句子的開頭
• 使Range的結束點為第二個句子的結尾
• 高亮顯示該Range

1.  
   public void SelectSentence()
2.  
   {
3.  
   Word.Range rng;
4.  
    
5.  
   if (ThisDocument.Sentences.Count >= 2 )
6.  
   {
7.  
   // Supply a Start and end value for the Range.
8.  
   Object start = ThisDocument.Sentences[ 2].Start;
9.  
   Object end = ThisDocument.Sentences[ 2].End;
10.  
    rng = ThisDocument.Range( ref start, ref end);
11.  
    rng.Select();
12.  
    }
13.  
    }

 

4.2 擴展Range

定義Range對象后，可以使用MoveStart和MoveEnd方法擴展它的范圍。這兩個函數使用兩個相同的參數：Unit與Count。其中Unit參數是WdUnits類型，它有如下可選值：

• wdCharacter
• wdWord
• wdSentence
• wdParagraph
• wdSection
• wdStory
• wdCell
• wdColumn
• wdRow
• wdTable

下面的例子演示了：定義一個Range包含文檔的前7個字符，然后移動其開始點7個字符長度，於是結果是原來的Range變成了一個insertion point；然后使用MoveEnd方法使其結束點移動7個字符

1.  
   // C#
2.  
   // Define a range of 7 characters.
3.  
   Object start = 0;
4.  
   Object end = 7;
5.  
   Word.Range rng = ThisDocument.Range( ref start, ref end);
6.  
    
7.  
   // Move the starting position 7 characters.
8.  
   Object unit = Word.WdUnits.wdCharacter;
9.  
   Object count = 7;
10.  
    rng.MoveStart( ref unit, ref count);
11.  
     
12.  
    // Move the ending position 7 characters.
13.  
    unit = Word.WdUnits.wdCharacter;
14.  
    count = 7;
15.  
    rng.MoveEnd( ref unit, ref count);

下圖展示了上述代碼的移動過程

 

4.3 獲得Range的首字符和尾字符

1.  
   MessageBox.Show(String.Format( "Start: {0}, End: {1}",
2.  
   rng.Start, rng.End), "Range Start and End");

 

4.4 使用SetRange方法

1.  
   // C#
2.  
   Word.Range rng;
3.  
   Object start = 0;
4.  
   Object end = 7;
5.  
   rng = ThisDocument.Range( ref start, ref end);
6.  
    
7.  
   // Reset the existing Range.
8.  
   rng.SetRange(ThisDocument.Sentences[ 2].Start,
9.  
   ThisDocument.Sentences[ 5].End);
10.  
    rng.Select();

 

4.5 格式化文本

若要給Range指定格式，你首先需要指定一個Range，然后應用格式。

下面的代碼演示了如下過程：

1.    選擇文檔中的第一段，然后設置字號字體以及對齊，

2.    彈出對話框

3.    調用三次Undo方法回退之前的操作

4.    應用Normal IndentStyle然后彈出對話框

5.    調用一次Undo方法然后彈出對話框

1.  
   // C#
2.  
   public void FormatRangeAndUndo()
3.  
   {
4.  
   // Set the Range to the first paragraph.
5.  
   Word.Range rng = ThisDocument.Paragraphs[ 1].Range;
6.  
    
7.  
   // Change the formatting.
8.  
   rng.Font.Size = 14;
9.  
   rng.Font.Name = "Arial";
10.  
    rng.ParagraphFormat.Alignment =
11.  
    Word.WdParagraphAlignment.wdAlignParagraphCenter;
12.  
    rng.Select();
13.  
    MessageBox.Show( "Formatted Range", "FormatRangeAndUndo");
14.  
     
15.  
    // Undo the three previous actions.
16.  
    Object times = 3;
17.  
    ThisDocument.Undo( ref times);
18.  
    rng.Select();
19.  
    MessageBox.Show( "Undo 3 actions", "FormatRangeAndUndo");
20.  
     
21.  
    // Apply the Normal Indent style.
22.  
    Object style = "Normal Indent";
23.  
    rng.set_Style( ref style);
24.  
    rng.Select();
25.  
    MessageBox.Show( "Normal Indent style applied",
26.  
    "FormatRangeAndUndo");
27.  
     
28.  
    // Undo a single action.
29.  
    times = 1;
30.  
    ThisDocument.Undo( ref times);
31.  
    rng.Select();
32.  
    MessageBox.Show( "Undo 1 action", "FormatRangeAndUndo");
33.  
    }

 

4.6 插入文本

你可以使用Range對象的Text屬性用於向文檔中插入文本。下面的代碼在文檔的開始處插入 “New Text”字符串。然后選擇該區域。

1.  
   // C#
2.  
   string str = " new Text ";
3.  
   Object start = 0;
4.  
   Object end = 0;
5.  
   Word.Range rng = ThisDocument.Range( ref start, ref end);
6.  
   rng.Text = str;
7.  
   rng.Select();

 

4.7 替換文本

1.  
   // C#
2.  
   start = 0;
3.  
   end = 12;
4.  
   rng = ThisDocument.Range( ref start, ref end);
5.  
   rng.Text = str;
6.  
   rng.Select();

4.8 Collapsing a Range of Selection

當使用Range對象或者Selection對象時，有可能需要在一段文字前插入文本的同時又不想覆蓋原來的文本，Range對象和Selection對象都有Collapse方法，該方法使用了兩個枚舉值：

WdCollapseStart：Collapses the selection to thebeginning of itself

WdCollapseEnd：Collapsesthe selection to the end of itself

下面的例子首先創建一個Range，然后使其包含文檔的第一段，然后使用wdCollapseStart枚舉值Collapse該Range，然后插入新文本。

1.  
   // C#
2.  
   string str = " new Text ";
3.  
   Word.Range rng = ThisDocument.Paragraphs[ 1].Range;
4.  
   Object direction = Word.WdCollapseDirection.wdCollapseStart;
5.  
   rng.Collapse( ref direction);
6.  
   rng.Text = str;
7.  
   rng.Select();

 

若使用wdCollapseEnd，即：

1.  
   // C#
2.  
   Object direction = Word.WdCollapseDirection.wdCollapseEnd;
3.  
   rng.Collapse( ref direction);

結果如下：

 

Tips ： Collapse不是很好去翻譯，通俗的說，它的功能是：當你的Range對象或者Selection對象包含的內容是一段文字時，使用Collapse()方法可以使 Range或者Selection包含的區域變成原來那段文字的前插入點或者后插入點

 

4.9 Paragraph Mark 段落標記

下面的代碼把文檔中的前兩段相互交換位置

重要例子

1.  
   public void ManipulateRangeText()
2.  
   {
3.  
   // Retrieve contents of first and second paragraphs
4.  
   string str1 = ThisDocument.Paragraphs[1].Range.Text;
5.  
   string str2 = ThisDocument.Paragraphs[2].Range.Text;
6.  
    
7.  
   // 兩個自然段相互交換
8.  
   Word.Range rng1 = ThisDocument.Paragraphs[ 1].Range;
9.  
   rng1.Text = str2;
10.  
     
11.  
    Word.Range rng2 = ThisDocument.Paragraphs[ 2].Range;
12.  
    rng2.Text = str1;
13.  
     
14.  
    // 顯示結果
15.  
    rng1.Select();
16.  
    MessageBox.Show(rng1.Text, "ManipulateRangeText");
17.  
    rng2.Select();
18.  
    MessageBox.Show(rng2.Text, "ManipulateRangeText");
19.  
    Object unit = Word.WdUnits.wdCharacter;
20.  
    Object count = -1;
21.  
    rng1.MoveEnd( ref unit, ref count);
22.  
    // Write new text for paragraph 1.
23.  
    rng1.Text = "new content for paragraph 1.";
24.  
     
25.  
    rng2.Text = "new content for paragraph 2.";
26.  
    // Pause to display the results.
27.  
    rng1.Select();
28.  
    MessageBox.Show(rng1.Text, "ManipulateRangeText");
29.  
    rng2.Select();
30.  
    MessageBox.Show(rng2.Text, "ManipulateRangeText");
31.  
     
32.  
    unit = Word.WdUnits.wdCharacter;
33.  
    count = 1;
34.  
    rng1.MoveEnd( ref unit, ref count);
35.  
    // Note that in C#, you must specify
36.  
    // both parameters--it's up to you
37.  
    // to calculate the length of the range.
38.  
    unit = Word.WdUnits.wdCharacter;
39.  
    count = rng2.Characters.Count;
40.  
    rng2.Delete( ref unit, ref count);
41.  
    // C#
42.  
    rng1.Text = str1;
43.  
    // C#
44.  
    rng1.InsertAfter(str2);
45.  
    rng1.Select();
46.  
    }

 

     本文概要性的介紹了word2007的幾大對象，主要是一些API的應用。后面將會通過實例，結合VS2010；來實現C#對Word的操作。

本文的PDF版本下載：            C#操作Word2007_v1.0.pdf

另有C#操作Excel的PDF下載：C#操作Excel2007_v1.0.pdf