LotusScript® のクラスでリッチテキストアイテム内を移動する

NotesDocument.GetFirstItem または NotesDocument.Items を使用して、リッチテキストアイテムとしてアイテムにアクセスします。NotesItem ではなく、NotesRichTextItem として戻り値を宣言します。

ナビゲーションでは、リッチテキストアイテムは NotesRichTextNavigator を使用してアクセスできる各種の要素の集まりです。 すべての種類の要素を検索したり、その要素へ移動できます。オブジェクトとして取得することのできる要素もあれば、NotesRichTextRange を使用しなければアクセスできないものもあります。要素には次のような種類があります。

• RTELEM_TYPE_DOCLINK (5) は文書リンクで、NotesRichTextDocLink オブジェクトとして取得できます。
• RTELEM_TYPE_FILEATTACHMENT (8) は添付ファイルで、EMBED_ATTACHMENT 形式の NotesEmbeddedObject として取得できます。
• RTELEM_TYPE_OLE (9) は OLE オブジェクトで、EMBED_OBJECT または EMBED_OBJECTLINK 形式の NotesEmbeddedObject として取得できます。
• RTELEM_TYPE_SECTION (6) は省略可能なセクションで、NotesRichTextSection オブジェクトとして取得できます。
• RTELEM_TYPE_TABLE (1) は表で、NotesRichTextTable オブジェクトとして取得できます。
• RTELEM_TYPE_TABLECELL (7) は表のセルで、NotesRichTextRange を使用してアクセスする必要があります。
• RTELEM_TYPE_TEXTPARAGRAPH (4) はテキスト段落で、NotesRichTextRange を使用してアクセスする必要があります。
• RTELEM_TYPE_TEXTRUN (3) は段落または同類の文字数の少ないもので、NotesRichTextRange を使用してアクセスする必要があります。

NotesRichTextNavigator オブジェクトを作成するには、NotesRichTextItem.CreateNavigator または NotesRichTextRange.Navigator を使用します。

ナビゲーションは同じ型の要素内で行われます。 ある型の最初の要素、次の要素、n 番目の要素を検索または取得できます。型に関係なく要素を検索または取得することはできません。

ナビゲータは現在位置を維持します。 検索と取得操作は、両方ともリッチテキストアイテム内での現在位置を変更します。

NotesRichTextNavigator には次のメソッドがあります。

• FindFirstElement は、現在の位置をリッチテキストアイテムの指定した種類の最初の要素に移動します。
• FindLastElement は、現在の位置をリッチテキストアイテムの指定した種類の最後の要素に移動します。
• FindNextElement は、現在の位置を、現在の位置の後にあるリッチテキストアイテムの指定した種類の次の要素に移動します。
• FindNthElement は、現在の位置を同じ種類の要素内の指定した位置にある要素に移動します。
• FindFirstString は、現在の位置をリッチテキストアイテムの最初の文字列の先頭に移動します。
• FindNexString は、現在の位置を、リッチテキストアイテム内で現在の位置より後ろにある次の文字列の先頭に移動します。
• GetElement は、現在の位置の要素を返します。
• GetFirstElement は、リッチテキストアイテム内にある指定されたタイプの最初の要素を返します。
• GetLastElement は、リッチテキストアイテム内にある指定された種類の最後の要素を返します。
• GetNextElement は、リッチテキストアイテム内で現在の位置の後の位置にある指定された種類の要素を返します。
• GetNthElement は、リッチテキストアイテム内の指定された位置にある指定された種類の要素を返します。
• SetPosition は、現在の位置をリッチテキストアイテム内の指定された要素に設定します。
• SetPositionAtEnd は、現在の位置をリッチテキストアイテム内の指定された要素の最後に設定します。
• SetCharOffset は、現在の位置を現在の位置からのオフセット位置に設定します。
• Clone は、現在と同じ位置を使用して、もう 1 つ NotesRichTextNavigator オブジェクトを作成します。