引言

本集開始，將會深入Document接口。打開或創(chuàng)建一個文檔都會產(chǎn)生一個Document對象，它代表文檔本身，所以絕大部分文檔的操作都會依賴該接口，它的屬性和方法共計374個！說不上很多，但它大部分的接口和屬性都是一個個獨立接口封裝而成的。

但不必?fù)?dān)憂，官方的文檔中顯示，有一部分接口是用于客戶端級編程的，我們只需要學(xué)習(xí)部分接口足以滿足各種類型的文檔級開發(fā)需求了。

Range是什么

這是本節(jié)課要講的接口，它是Document的方法，但其本身也是一個獨立的接口，方法和屬性共計183個。Range這個接口簡直是word接口中的勞模。它表示資源選中或插入點，可以理解為一個看不見的鼠標(biāo)，但它比鼠標(biāo)的作用強大多了。官方也提供了Selection接口，這是正兒八經(jīng)的鼠標(biāo)，它能和鼠標(biāo)交互，個人認(rèn)為Selection適合用在客戶端級開發(fā)的場景，文檔級開發(fā)的場景還是Range好用。

Range的作用

操作文檔中的資源，如選中一段文字，在實操中，得先鼠標(biāo)選中文字。在word編程中，使用Range就能實現(xiàn)資源的選中，Selection是單例模式，Range可不是，最近的一個Range實例不會覆蓋前面的實例，每個實例都是獨立存在的。

Range聲明范圍的三種形式

from win32com.client import Dispatch
client = Dispatch('word.Application')
client.Visible = 1
# 創(chuàng)建一個文檔 返回一個Document對象 操作文檔就必須要操作Document
doc = client.Documents.Add()

此時，客戶端上已經(jīng)創(chuàng)建了一個新文檔，為了方便演示，先在文檔中粘貼一段新聞：

使用Range聲明文檔全選

rng1 = doc.Range()

沒什么可講的，真的太簡單了，如果你剛接觸Python不久且無其他編程語言基礎(chǔ)，只需要記住，Range接口返回一個Range對象，表示當(dāng)前被選中的內(nèi)容，僅此。

使用Range聲明選擇某范圍資源

用法 Range(Start: int, End: int) -> Range

Start和End表示字符，表示選擇了從Start開始，截至End的范圍。

rng2 = doc.Range(0,10)

使用Range聲明一個無內(nèi)容的范圍：插入點

rng3 = doc.Range(20,20)

當(dāng)起始位置和結(jié)束位置一樣時，Range中就無內(nèi)容了，它是一個點，這種插入點通常用來往插入點寫入內(nèi)容。這樣做很方便，不必?fù)?dān)心因為誤操作而導(dǎo)致范圍中的內(nèi)容被替換。

Range.Text屬性

Text屬性內(nèi)部有__setter__，可以使用該屬性來獲取或設(shè)置范圍中的內(nèi)容。打印Range實例時，會返回一個<COMObject Range>，看不到實例細(xì)節(jié)，此時可以使用Text屬性查看范圍中的文本。

使用Text屬性獲取范圍中的內(nèi)容

rng2 = doc.Range(0,4)
print(rng2.Text)
>>>
'總部大樓'

Range.Start & Range.End 屬性

兩個屬性分別可以獲取或設(shè)置范圍的起始位置和結(jié)束位置，在實操中，有時候Range的范圍并不是通過Range(Start, End)這種方式來聲明的，而是某種方式，比如使用Document.Paragraphs(1)獲得文章第一段，而某些操作只能在Range對象下才能操作，那么可以使用，Document.Paragraphs(1).Range將第一段的段落對象轉(zhuǎn)換成了Range對象，此時就可以通過Range.End來獲得范圍的結(jié)束位置啦。

當(dāng)然，這兩個屬性也是實現(xiàn)了__setter__方法的，意味著可以通過為屬性賦值來改變Range的范圍。

更改Range的范圍

在word編程中，更改Range范圍是常規(guī)操作，上面的Start和End屬性可以實現(xiàn)，但復(fù)雜的需求和編程環(huán)境是不允許我們來數(shù)數(shù)有幾個字符的，這不現(xiàn)實。所以，微軟官方提供了非常豐富的接口來實現(xiàn)Range范圍的更改，比如，下面要講的MoveStart和MoveEnd方法。

MoveStart & MoveEnd方法

1、MoveStart(Unit=1, Count=1)

該方法可以改變范圍的起始位置，可以擴(kuò)大范圍也可以減少范圍，參數(shù)說明：

• Unit： 按什么單位移動，1表示字符，3表示句子，4表示段落，
• Count： 執(zhí)行一次要移動多少個Unit，正數(shù)表示往前移動（文檔結(jié)束的方向），負(fù)數(shù)表示往后移動（文檔開頭的方向）

2、MoveEnd(Unit=1, Count=1)

參數(shù)和MoveStart一模一樣。

演示

rng3 = doc.Range(0,4)
rng3.MoveStart(Unit=4, Count=1)
print(rng3.Start, rng2.End)
# 移動后打印起始位置和結(jié)束位置
>>>
(262, 262)

明明只移動了起始位置，但為何結(jié)束位置從原來的4也變成了262字符位置了呢？請看下方說明：

說明 無論是MoveStart還是MoveEnd，如果一方的位置超越了另一方，兩個點就會重疊并形成插入點，最后一起移動到目標(biāo)位置，不可能會出現(xiàn)結(jié)束位置小于起始位置這種匪夷所思的情況。

這種玩法就很妙，意味著，我們不需要在意到底要數(shù)到第幾個字符就可以輕松獲得一個Range的范圍。

使用Range寫入文本

Range.Text重新賦值實現(xiàn)插入

前面所示，可以使用Range.Text屬性重新賦值，這很簡單，就演示個偽代碼吧。

# 偽代碼
# 在0,0的位置聲明一個插入點
rng1 = doc.Range(0,0)
# 使用Text屬性插入內(nèi)容
rng1.Text = '一燈編程'

注意： 除非你想替換范圍中的內(nèi)容，否則不要輕易使用有內(nèi)容的范圍來執(zhí)行doc.Range(0,10).Text = '插入的內(nèi)容'語句。

InsertBefore和InsertAfter方法插入

InsertBefore：在范圍的起始位置插入內(nèi)容

InsertAfter：在范圍的結(jié)束位置插入內(nèi)容

這兩個方法是為有內(nèi)容的范圍量身訂造的，我想，千言萬語不如一張圖來得直接（懶）。

注意：兩個方法會擴(kuò)大原來的范圍

插入段落標(biāo)記

另起一段是word編輯中常用的功能，使用回車即可實現(xiàn)，在word編程中，有三個方法可以實現(xiàn)的。

InertParagraph

使用段落標(biāo)記\r替換原來范圍中的內(nèi)容，并形成新段落。

rng4 = doc.Range(20,20)
rng4.InsertParagraph()

該方法適用于插入點，因為它會使用自動執(zhí)行以下代碼：

rng4.Text = '\r'

意味著，\r會替換原來范圍中的內(nèi)容，除非有這個必要。執(zhí)行這個方法后，從字符21開始，后面的內(nèi)容都會另起一段。

InsertParagraphBefore

在范圍起始位置插入一個段落標(biāo)記\r，意思是在原來內(nèi)容的基礎(chǔ)上，在起始位置插入一個\r，那么當(dāng)前范圍會形成一個新段落，假如原來的內(nèi)容為一燈編程，執(zhí)行該方法后，內(nèi)容為\r一燈編程。

rng5 = doc.Range(4,8)
rng5.InsertParagraphBefore()
print(rng5.Text)
>>>
"\r一燈編程"

InsertParagraphAfter

和InsertParagraphBefore相反，它會在結(jié)束位置插入\r，作用完全一樣，不作演示。

最后

Document需要講的內(nèi)容很多，僅Range接口就能講很多集。學(xué)習(xí)不能急，但也不能懶，代碼敲起來，沒有學(xué)不會的內(nèi)容。

以上就是學(xué)習(xí)win32com操作word之Range精講的詳細(xì)內(nèi)容，更多關(guān)于Range win32com操作word的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論