Aspose.words 書籤定位

標籤：img   log   文檔   電子   book   內容   images   連結庫   其他   

1. 簡介

Aspose.words 可以在不使用 Microsoft.Word 的情況下產生、修改、轉換、列印文檔。不依賴office組件，這一點給我們提供了極大的便利性，可以簡單的引入 DLL(Dynamic Link Library，動態連結程式庫檔案) ，就可以操作 word 文檔。不過也有一點小小的麻煩就是需要許可證 Aspose.Words.lic 。

 

2. word 文檔結構

既然要操作 word 文檔，就要先簡單瞭解一下 word 對於 aspose 來說是一個怎樣的對象。word 在 aspose中是一個 DOM(Document Object Model ，文件物件模型) 。我們先來看一下 word文檔在aspose 中的模型圖。

                       

 

這上面節點的具體內容可以先暫時不用理會，到了具體的使用情境，如果你要修改一個頁首，可以查一下，頁首是屬於哪一個節點，有哪些屬性。我們先建立一個DOM 的大概理解 : 根節點為 Document ，最底層節點為 Run 的一棵樹。

 

3. 查看 DOM

aspose提供了查看DOM 的工具 DocumentExplorer，可以在 github 中下載。地址：https://github.com/aspose-words/Aspose.Words-for-.NET 。左側的是與文檔結構對應的樹，右側是節點中的一些編碼內容。看這棵樹是為了對 DOM 有一個直觀的認識。

 

 

4. 為了有更加深刻的理解，我們實現一個小案例

假設有一份word文檔， 給定一個 BookMark(書籤)的名稱，怎麼知道這個書籤在文檔中的位置。我們先簡單定位到頁數，也就是說已知 Document (文檔) 這個對象，BookMark（書籤）的名稱，要求解 這個BookMark 在文檔中的 PageIndex （頁數）。

 

書籤在word 中的樣子。

 

 

這個介面告訴我們書籤 有 名稱、位置 兩個變數。 可以執行 添加、刪除、定位、隱藏操作。

 

接下來看一下書籤在 aspose 中的實現。

 

在 Aspose 中書籤的Name 對應名稱，可以取值賦值，Text 是書籤的值，這個在我們開啟word 書籤介面的時候沒有直接輸入的地方，可能可以通過其他方式賦值。BookmarkStart 書籤開始的地方，BookmarkEnd 書籤結束的地方。 有開始的位置也有結束的位置，這說明書籤是一段內容。（更準確的說，是word的文檔協議先定義了書籤有開始標記和結束標記，aspose根據這個協議，才有了 BookmarkStart 和 BookmarkEnd），我們可以把一整頁設為書籤，也可以把一張圖片設為一個書籤。如果書籤是一個游標，那麼開始和結束標記都是這個游標所在的位置。我們已經有個整個文檔的對象 Aspose.words.Document , 書籤對象 Aspose.words.BookMark , 書籤開始對象 Aspose.words.BookmarkStart, 書籤結束對象 Aspose.words.BookmarkEnd。

一份文檔中有很多書籤，如何找到其中的一個。首先找到所有的 Bookmark

Aspose.Words.BookmarkCollection ，然後根據 bookmarkName找到某一個書籤

 

 

要實現我們的Case（還記得嗎，根據書籤定位到頁數），是不是應該要有一個 類似 int i = GetPageIndex ( BookMark bookmark ) 的 API 。好像還真有一個實現了類似功能的API 。 Aspose.Words.Layout.LayoutCollector (不要問我怎麼知道這個API的) 。LayoutCollector 字面意思：布局收集器。可以理解為文檔中所有節點位置資訊的集合。

 

 

不過還有一個問題：參數是 Node，這又是一個怎樣的存在，一個抽象類別。

 

 

那麼 Bookmark 與 Node 是什麼關係。

要回答這個問題就要看 BookmarkStart 這個對象，它既是 Node，也是 Bookmark 開始的位置。

 

 

到這個時候感覺有好幾個對象，有點亂，隱約有點關聯。試著建立他們之間的聯絡。

這樣我們可以從 Document(文檔）——> Bookmark(書籤) ——> BookmarkStart (書籤開始節點) ——> Node（節點） ——> PageIndex （頁數）

Document doc = new Document(string fileName);Bookmark bookmark = doc.Range.Bookmarks["bookmarkName"];int pageIndex = new LayoutCollector(doc).GetStartPageIndex(bookmark.bookmarkStart);

 

這個地方我們定位到了一個書籤開始位置的頁數。有了頁數，就可以用aspose 中的列印功能直接跳轉到這一頁顯示。

這時，發現剛剛提的那個問題，好像有點不太對。

嚴格來說應該是： 一個書籤在文檔中開始的頁數 和 結束的頁數分別是多少。 當然大部分情況下都是在同一頁的。我們實際生活中接觸到的是夾在兩頁之間的書籤。word 文檔中的電子書籤在這個定位的功能上有了擴充。可以定位一個字、一段話、一張圖片、還有很多其他意想不到的作用。

 

 

5.尋找關鍵API

整個過程中有個地方比較微妙，就是如何尋找 public int GetStartPageIndex(Node node) 這個關鍵API，如果你時間比較倉促，那就在官方提供的Demo中 用VS開啟,檢索 bookmark 、Page、Index 這幾個關鍵字，一個單詞一個單詞分別查，可能會查到很多相關的，每一條快速探索一下，這個API就在其中，有時比較難發現。這種尋找方式，需要Demo作者對方法的命名比較規範，命名要有意義，與所做的事對應起來。我們自己在開發過程中命名的時候，如果感覺一個方法命名很糾結，不能用一兩個單詞表達所做的事情，或者無論如何寫注釋，都感覺沒講清楚的時候，那很有可能這個方法本身就是有問題的，它做的事情太多了，需要拆分。如果你有比較充足的時間，那就把官方Demo的例子都跑一下，你要找的API,在你調試某一個例子的過程中可能會發現，當然也可能沒有現成的方法能實現你的需求，那就用其他方法繼續查，StackOverflow 也可以。各種嘗試之後不行，可以回到源頭，想一下這個需求是不是本身就有問題，是不是可以換個方式實現。“否定問題是解決問題最好的方法”。

 

 

Aspose.words 書籤定位