使用LotusScript操做Lotus Notes RTF域

Lotus Notes RTF域的功能也很是強大，除了支持普通的文本之外，還支持圖片、表格、嵌入對象、Http 連接、Notes 連接、附件等等衆多的類型。本文將介紹如何使用這些類來靈活操做富文本域。

操做 Notes 富文本域相關的 LotusScript 類

和操做 Notes 富文本域相關的 LotusScript 類包括：

NotesRichTextNavigator 富文本域的導航器，用來訪問富文本域中的各類元素； 
NotesRichTextRange 表示富文本域內容的一個範圍，能夠包括多個元素； 
NotesRichTextDocLink 表示富文本域內容的文檔連接； 
NotesEmbeddedObject 表示嵌入式對象或者文件附件； 
NotesRichTextSection 表示富文本域中的一個區段； 
NotesRichTextTable 表示富文本域中的表格； 
NotesRichTextStyle 表示富文本的各類屬性； 
NotesRichTextParagraphStyle 表示富文本段落的各類屬性； 
NotesColorObject 表示一種顏色。

程序中使用的一些方法。

NotesSession.CreateRichTextStyle：建立一個 NotesRichTextStyle 對象。 
NotesSession.CreateRichTextParagraphStyle：建立一個 NotesRichTextParagraphStyle 對象。 
NotesSession.CreateColorObject：建立一個 NotesColorObject 對象。 
須要注意的是 NotesRichTextStyle，NotesRichTextParagraphStyle 和 NotesColorObject 這三種對象是不能用 New 來建立的，由於這三個類沒有 New() 方法，只能經過 NotesSession 來建立。

NotesRichTextItem.AppendStyle：在當前位置插入一個格式對象，該位置之後的格式都使用這種格式，直到插入了另一個格式。 
NotesRichTextItem.AppendParagraphStyle：在當前位置插入一個段落格式對象，該位置之後的段落格式都使用這種格式，直到插入了另一個段落格式。 
NotesRichTextItem.BeginSection：在富文本域中插入一個區段。 
NotesRichTextItem.EndSection：區段結束，必須和 BeginSection 配對使用。 
在兩個方法之間能夠經過各類 append 方法添加各類元素。插入區段的時候，區段老是在富文本域的最後。還須要注意的是不能建立一個包含富文本域中已有的元素的區段，經過 BeginSection 方法建立的區段老是空的，區段的內容須要經過程序本身添加。

NotesRichTextItem.CreateNavigator：建立一個富文本域導航器對象 NotesRichTextNavigator。 
建立一個富文本域導航器只能使用這種方法，NotesRichTextNavigator 也沒有 new 方法。也能夠 NotesRichTextRange.Navigator 屬性來獲得一個 NotesRichTextNavigator 對象。

NotesRichTextNavigator 類是用來靈活訪問操做富文本域裏的內容的最重要的一個類，經過它的一些方法，能夠方便的訪問到各類富文本域中的元素。 
導航器對象 NotesRichTextNavigator 會維護一個當前位置，任何在富文本域中的 get 或者 find 的操做均可能會改變這個當前位置。導航總髮生在同一種類型的元素中，主要經過 find 和 get 兩類方法來訪問相應的元素，找到須要的元素後，再經過 get 方法來取得這個元素。下表列出了這些方法。

NotesRichTextItem.BeginInsert：將插入位置從富文本域結尾處改成指定元素的開始或者結尾處。

NotesRichTextItem.EndInsert：將插入位置重置到富文本域的結尾處，須要和 BeginInsert 配對使用。

在兩個方法之間能夠經過各類 append 方法添加各類元素。咱們來看看 BeginInsert 的具體使用方法：

Call notesRichTextItem.BeginInsert( element, [ after ] )

參數說明

element：能夠是 NotesEmbeddedObject, NotesRichTextDocLink, NotesRichTextNavigator, NotesRichTextRange, NotesRichTextSection, 或者 NotesRichTextTable，表示該對象的位置 . 若是是 NotesRichTextNavigator 則表示此 NotesRichTextNavigator 對象所表示的當前位置。

After：布爾型可選參數，True 表示插入位置在元素的末尾，False（缺省值）表示插入位置在元素的開頭。