|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
テキスト用のコンテナであり、編集をサポートし、変更の通知を提供します (MVC 関係内のモデルとして機能する)。変更を追跡する構造でテキストをマークアップするためのサポートが提供されています。構造の単位は要素と呼ばれます。ビューは一般的に要素構造から構築されます。各要素は、それに関連付けられている任意の属性セットを持つことができます。ドキュメント構造の本質は実装で指定されるので、インタフェース自身は提供される構造のあらゆるポリシーの制約を受けないように意図されています。
一般的にドキュメント構造は 1 つだけですが、インタフェースはテキストデータに関して構造プロジェクションを任意の数だけ構築できるようにサポートしています。ドキュメントは、複数のドキュメント構造をサポートする複数のルート要素を持つことができます。以下に、例をいくつか示します。
DocumentEvent
,
DocumentListener
,
Element
,
Position
,
AttributeSet
フィールドの概要 | |
static String |
StreamDescriptionProperty
ドキュメントを初期化するのに使うストリーム記述のプロパティ名です。 |
static String |
TitleProperty
ドキュメントのタイトルがあれば、そのプロパティ名です。 |
メソッドの概要 | |
void |
addDocumentListener(DocumentListener listener)
ドキュメントに変更が加えられたときに通知の受信を開始するように、指定されたオブザーバを登録します。 |
void |
addUndoableEditListener(UndoableEditListener listener)
ドキュメントに取り消し可能な編集が加えられたときに通知の受信を開始するように、指定されたオブザーバを登録します。 |
Position |
createPosition(int offs)
ドキュメントの変更に応じて変更を追跡する位置を返します。 |
Element |
getDefaultRootElement()
ビューを要素構造に割り当てるほかの特定の機構が提供されていないかぎり、ビューのベースとなるルート要素を返します。 |
Position |
getEndPosition()
ドキュメントの末尾を表す位置を返します。 |
int |
getLength()
ドキュメント内の現在のコンテンツの文字数を返します。 |
Object |
getProperty(Object key)
ドキュメントに関連付けられているプロパティを取得します。 |
Element[] |
getRootElements()
定義されているすべてのルート要素を返します。 |
Position |
getStartPosition()
ドキュメントの先頭を表す位置を返します。 |
String |
getText(int offset,
int length)
ドキュメントの指定部分内にあるテキストを取得します。 |
void |
getText(int offset,
int length,
Segment txt)
ドキュメントの指定部分内にあるテキストを取得します。 |
void |
insertString(int offset,
String str,
AttributeSet a)
コンテンツの文字列を挿入します。 |
void |
putProperty(Object key,
Object value)
新しいプロパティをリストに置きます。 |
void |
remove(int offs,
int len)
ドキュメントのコンテンツの一部を削除します。 |
void |
removeDocumentListener(DocumentListener listener)
指定されたオブザーバを通知リストから登録解除して、それ以上変更の更新を受信しないようにします。 |
void |
removeUndoableEditListener(UndoableEditListener listener)
指定されたオブザーバを通知リストから登録解除して、それ以上更新を受信しないようにします。 |
void |
render(Runnable r)
モデルが非同期的な更新をサポートしている場合、並行性に直面してモデルを安全に描画できるようにします。 |
フィールドの詳細 |
public static final String StreamDescriptionProperty
public static final String TitleProperty
メソッドの詳細 |
public int getLength()
public void addDocumentListener(DocumentListener listener)
listener
- 登録対象のオブザーバremoveDocumentListener(javax.swing.event.DocumentListener)
public void removeDocumentListener(DocumentListener listener)
listener
- 登録対象のオブザーバaddDocumentListener(javax.swing.event.DocumentListener)
public void addUndoableEditListener(UndoableEditListener listener)
listener
- 登録対象のオブザーバUndoableEditEvent
public void removeUndoableEditListener(UndoableEditListener listener)
listener
- 登録対象のオブザーバUndoableEditEvent
public Object getProperty(Object key)
key
- null 以外のプロパティpublic void putProperty(Object key, Object value)
key
- null 以外のプロパティキーvalue
- プロパティ値public void remove(int offs, int len) throws BadLocationException
offs
- 先頭からのオフセット >= 0len
- 削除対象の文字数 >= 0DocumentEvent
,
DocumentListener
public void insertString(int offset, String str, AttributeSet a) throws BadLocationException
offset
- コンテンツを挿入するドキュメントに対するオフセット >= 0。指定位置やその後の変更を追跡するすべての位置が移動str
- 挿入対象の文字列a
- 挿入されたコンテンツに関連付ける属性。属性がない場合は nullDocumentEvent
,
DocumentListener
public String getText(int offset, int length) throws BadLocationException
offset
- テキストの望ましい先頭を表す、ドキュメントに対するオフセット >= 0length
- 望ましい文字列の長さ >= 0public void getText(int offset, int length, Segment txt) throws BadLocationException
offset
- テキストの望ましい先頭を表す、ドキュメントに対するオフセット >= 0length
- 望ましい文字列の長さ >= 0txt
- テキストを返す先の Segment オブジェクトpublic Position getStartPosition()
public Position getEndPosition()
public Position createPosition(int offs) throws BadLocationException
offs
- ドキュメントの先頭からのオフセット >= 0public Element[] getRootElements()
public Element getDefaultRootElement()
public void render(Runnable r)
r
- モデルを描画するために使う実行可能ファイル
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |