Java™ クラスでテキストを処理する

テキストには、テキスト段落やテキストラン、リッチテキストスタイル、リッチテキスト段落スタイル、タブが含まれます。テキストランは、スタイルが変更されるか、段落が終了されるまで続くテキストです。

テキスト段落とテキストラン

リッチテキストアイテム内のテキストを検索するには、RichTextNavigator メソッドを RichTextItem.RTELEM_TYPE_TEXTPARAGRAPH または RichTextItem.RTELEM_TYPE_TEXTRUN のいずれかの型と一緒に使用します。テキストを取得するには、createRange を使用して RichTextRange オブジェクトを作成し、次のメソッドでテキストを定義します。

setBegin は、範囲の始まりを定義します。
setEnd は、範囲の終わりを定義します。

例えば、RichTextItem.RTELEM_TYPE_TEXTPARAGRAPH の型の要素を RichTextNavigator で検索し、setBegin を呼び出してそれをナビゲータに渡すと、その段落から範囲が始まります。

RichTextRange クラスには、次のプロパティがあります。

プロパティ	データ型	説明
getNavigator	RichTextNavigator	その範囲に限定したナビゲータ。これを使用して、例えばテキスト段落内のテキストランを取得できます。
getStyle	RichTextStyle	範囲内で最初のテキストランのスタイルです。
getTextParagraph	String	範囲内の最初の段落のテキストです。
getTextRun	String	範囲内の最初のランのテキストです。
getType	String	範囲内で最初の要素の型です。

RichTextRange クラスには、setBegin と setEnd 以外に次のメソッドもあります。

Clone は、現在の範囲から、別の RichTextRange オブジェクトを作成します。
findAndReplace は、範囲内で見つかった文字列を置換します。
remove は、指定した範囲の要素を削除します。
reset は、指定した範囲をデフォルト値にリセットします。
setStyle は、指定した範囲内のすべてのテキストを、指定したスタイルに設定します。

テキストを作成する

リッチテキストアイテムのテキストを作成するには、次のメソッドを使用します。

addNewLine は、リッチテキストアイテムの最後に 1 行以上の新規行 (改行) を追加します。
addPageBreak は、RichTextItem の最後に強制改ページを追加します。
addTab は、リッチテキストアイテムの最後に 1 つ以上のタブを追加します。
appendText は、リッチテキストアイテムの最後にテキストを追加します。テキストはアイテムの現在のスタイルになります
appendRTItem は、1 つのリッチテキストアイテムの内容を別のリッチテキストアイテムの最後に追加します。

リッチテキストスタイル

リッチテキストスタイルのプロパティには RichTextStyle クラスを使用してアクセスできます。RichTextStyle クラスには、次のプロパティが含まれています。

プロパティ	データ型	説明
getBold と setBold	int 型	リッチテキストの太字属性です。
getEffects と setEffects	int 型	効果 (エンボス、絞り出しなど) です。
getFont と setFont	int 型	リッチテキストのフォント属性です。
getFontSize と setFontSize	int 型	ポイント単位で表したフォントサイズです。
isDefault	boolean 型	すべての属性がデフォルトの場合です。
getItalic と setItalic	int 型	リッチテキストの斜体属性です。
getColor と setColor	int 型	リッチテキストの色属性です。
getParent	Session	RichTextStyle オブジェクトを含むセッションです。
getPassThruHTML と setPassThruHTML	int 型	HTML 属性です。
getStrikeThrough と setStrikeThrough	int 型	リッチテキストの取り消し線属性です。
getUnderline と setUnderline	int 型	リッチテキストの下線属性です。

appendStyle メソッドは、リッチテキストアイテムの最後にスタイルを追加します。スタイルに続く文字列は、別のスタイルが追加されるまで、そのスタイル属性が適用されます

Font のフォント識別子を設定するには、RichTextItem 内で getNotesFont を使用します。

リッチテキスト段落スタイル

RichTextParagraphStyle によって、次のようなリッチテキスト段落オブジェクトの属性にアクセスできます。

プロパティ	データ型	説明
getAlignment と setAlignment	int 型	リッチテキスト段落の文字揃え属性です。
getFirstLineLeftMargin と setFirstLineLeftMargin	int 型	リッチテキスト段落の最初の行マージン属性です。
getInterLineSpacing と setInterLineSpacing	int 型	リッチテキスト段落の行間隔属性です。
getLeftMargin と setLeftMargin	int 型	リッチテキスト段落の左マージン属性です。
getRightMargin と setRightMargin	int 型	リッチテキスト段落の右マージン属性です。
getSpacingAbove と setSpacingAbove	int 型	リッチテキスト段落の段落前の間隔属性です。
getSpacingBelow と setSpacingBelow	int 型	リッチテキスト段落の段落下の間隔属性です。
getTabs	RichTextTab のベクトル	リッチテキスト段落スタイルのタブです。

新しいリッチテキスト段落スタイルオブジェクトを作成するには、Session の createRichTextParagraphStyle メソッドを使用します。

タブ

リッチテキスト段落スタイルオブジェクト中のタブは、RichTextParagraphStyle と RichTextTab の各クラスの clearAllTabs、setTab、setTabs、clear の各メソッドを使用して操作できます。

RichTextTab クラスには、次のプロパティがあります。

プロパティ	説明
getPosition	リッチテキスト段落スタイルのタブの位置です。
getType	タブの種類です。