モジュール java.desktop

パッケージ javax.swing.text

インタフェースStyledDocument

すべてのスーパー・インタフェース:

Document

既知のすべての実装クラス:

DefaultStyledDocument, HTMLDocument

public interface StyledDocument extends Document

書式付きドキュメントのジェネリック・インタフェースです。

フィールドのサマリー

インタフェースjavax.swing.text.Documentで宣言されているフィールド

StreamDescriptionProperty, TitleProperty

メソッドのサマリー

修飾子と型	メソッド	説明
Style	addStyle(String nm, Style parent)	論理書式階層に新しい書式を追加します。
Color	getBackground(AttributeSet attr)	属性セットを取得してバックグラウンド・カラー指定に変換します。
Element	getCharacterElement(int pos)	ドキュメント内の指定されたオフセットにある文字を表す要素を返します。
Font	getFont(AttributeSet attr)	属性セットを引数として、フォント指定に変換します。
Color	getForeground(AttributeSet attr)	属性セットを取得してフォアグラウンド・カラー指定に変換します。
Style	getLogicalStyle(int p)	段落内の指定された位置の論理書式を取得します。
Element	getParagraphElement(int pos)	ドキュメント内の指定されたオフセットを含む段落を表す要素を返します。
Style	getStyle(String nm)	以前に追加された名前付き書式を取得します。
void	removeStyle(String nm)	以前にドキュメントに追加された名前付き書式を削除します。
void	setCharacterAttributes(int offset, int length, AttributeSet s, boolean replace)	ドキュメント内の指定された範囲の既存のコンテンツに使用されているコンテンツ要素属性を変更します。
void	setLogicalStyle(int pos, Style s)	指定された位置の段落に使用する論理書式を設定します。
void	setParagraphAttributes(int offset, int length, AttributeSet s, boolean replace)	段落の属性を設定します。

インタフェースjavax.swing.text.Documentで宣言されたメソッド

addDocumentListener, addUndoableEditListener, createPosition, getDefaultRootElement, getEndPosition, getLength, getProperty, getRootElements, getStartPosition, getText, getText, insertString, putProperty, remove, removeDocumentListener, removeUndoableEditListener, render

メソッドの詳細

addStyle

Style addStyle(String nm, Style parent)

論理書式階層に新しい書式を追加します。 書式の属性は下から上に向かって解釈処理されるので、子で指定された属性は親で指定された属性をオーバーライドします。

パラメータ:

nm - 書式の名前(名前付き書式のコレクション内で一意である必要がある)。 書式に名前が付いていない場合はこの名前をnullにしても構わないが、呼出し側は名前のない書式が名前で取得できない場合に返される参照を管理する責任がある。 名前のない書式は、スタイル・ランで見られるような文字属性のオーバーライドなどで便利な場合がある。

parent - 親書式。 指定されていない属性がほかの書式で解釈処理される必要がない場合はnullも可。

戻り値:

書式

removeStyle

void removeStyle(String nm)

以前にドキュメントに追加された名前付き書式を削除します。

パラメータ:

nm - 削除される書式の名前

getStyle

Style getStyle(String nm)

以前に追加された名前付き書式を取得します。

パラメータ:

nm - 書式の名前

戻り値:

書式

setCharacterAttributes

void setCharacterAttributes(int offset, int length, AttributeSet s, boolean replace)

ドキュメント内の指定された範囲の既存のコンテンツに使用されているコンテンツ要素属性を変更します。 指定された属性引数で定義されているすべての属性が、指定された範囲に適用されます。 このメソッドでは、属性の定義されていない属性引数を使い、replaceをtrueに設定することで、指定された範囲のコンテンツ・レベルのすべての属性を完全に削除できます。

パラメータ:

offset - 変更の開始>= 0

length - 変更の長さ>= 0

s - null以外の新しい属性。 定義済みのすべての属性は指定された範囲のテキストに適用される。

replace - 新しい属性の設定の前に以前の属性をクリアするかどうかを示す。 trueの場合、以前の属性がすべて置き換えられる。 falseの場合、新しい属性が以前の属性とマージされる。

setParagraphAttributes

void setParagraphAttributes(int offset, int length, AttributeSet s, boolean replace)

段落の属性を設定します。

パラメータ:

offset - 変更の開始>= 0

length - 変更の長さ>= 0

s - null以外の新しい属性。 定義済みのすべての属性は指定された範囲のテキストに適用される。

replace - 新しい属性の設定の前に以前の属性をクリアするかどうかを示す。 trueの場合、以前の属性がすべて置き換えられる。 falseの場合、新しい属性が以前の属性とマージされる。

setLogicalStyle

void setLogicalStyle(int pos, Style s)

指定された位置の段落に使用する論理書式を設定します。 文字および段落の属性に対して明示的に属性が設定されていない場合、属性はその段落に割り当てられている論理書式を介して解釈処理されます。同様に、論理書式はドキュメント内の要素階層にまったく依存しない階層を介して解釈処理されます。

パラメータ:

pos - 開始位置>= 0

s - 設定する書式

getLogicalStyle

Style getLogicalStyle(int p)

段落内の指定された位置の論理書式を取得します。

パラメータ:

p - 位置>= 0

戻り値:

書式

getParagraphElement

Element getParagraphElement(int pos)

ドキュメント内の指定されたオフセットを含む段落を表す要素を返します。

パラメータ:

pos - オフセット>= 0

戻り値:

要素

getCharacterElement

Element getCharacterElement(int pos)

ドキュメント内の指定されたオフセットにある文字を表す要素を返します。

パラメータ:

pos - オフセット>= 0

戻り値:

要素

getForeground

Color getForeground(AttributeSet attr)

属性セットを取得してフォアグラウンド・カラー指定に変換します。 明るさや色合いなどを強調する場合に使用します。

パラメータ:

attr - 属性セット

戻り値:

色

getBackground

Color getBackground(AttributeSet attr)

属性セットを取得してバックグラウンド・カラー指定に変換します。 明るさや色合いなどを強調する場合に使用します。

パラメータ:

attr - 属性セット

戻り値:

色

getFont

Font getFont(AttributeSet attr)

属性セットを引数として、フォント指定に変換します。 このメソッドを使用すると、ファミリ、書式、サイズなどを、ドキュメントが現在使用されているシステムで使用できるフォントに変換できます。

パラメータ:

attr - 属性セット

戻り値:

フォント