|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface CharacterData
CharacterData
インタフェースは、属性とメソッドのセットを追加して Node を拡張することにより、DOM 内の文字データにアクセスできるようにします。こうしたセットについては、これらを実際に使用するオブジェクトの項で説明するのではなく、ここでまとめて説明しておきます。直接 CharacterData
に対応する DOM オブジェクトは存在しません。 一方、Text
などのその他のオブジェクトは CharacterData
からインタフェースを継承します。このインタフェースに含まれるすべての offsets
は 0
で始まります。
DOMString
インタフェースの解説でも触れましたが、DOM に含まれるテキスト文字列は UTF-16、すなわち 16 ビットを 1 単位とするシーケンスで表現されます。次の説明では、「16 ビット単位」という表現で、CharacterData へのインデックス付けが 16 ビット単位で行われるということを示します。
「Document Object Model (DOM) Level 3 Core Specification」を参照してください。
フィールドの概要 |
---|
メソッドの概要 | |
---|---|
void |
appendData(String arg)
ノードの文字データの末尾に文字列を追加します。 |
void |
deleteData(int offset,
int count)
ノードから指定範囲の 16 ビット単位を削除します。 |
String |
getData()
このインタフェースを実装するノードの文字データです。 |
int |
getLength()
以下の data メソッドおよび substringData メソッドを介して取得可能な 16 ビット単位の数です。 |
void |
insertData(int offset,
String arg)
指定された 16 ビット単位のオフセットに文字列を挿入します。 |
void |
replaceData(int offset,
int count,
String arg)
指定された文字列で、指定された 16 ビット単位のオフセット以降の文字を置き換えます。 |
void |
setData(String data)
このインタフェースを実装するノードの文字データです。 |
String |
substringData(int offset,
int count)
ノードから所定のデータ範囲を抽出します。 |
メソッドの詳細 |
---|
String getData() throws DOMException
CharacterData
ノードに格納できるデータの量を制限しません。しかし、あるノードのデータ全体が単一の DOMString
に収まらない場合は、実装の制限が有効になります。この場合、ユーザーは substringData
を呼び出し、データを適切なサイズに分割して取得できます。
DOMException
- DOMSTRING_SIZE_ERR:返される文字数が多すぎて
実装プラットフォーム上の DOMString
変数に収まらない場合void setData(String data) throws DOMException
CharacterData
ノードに格納できるデータの量を制限しません。しかし、あるノードのデータ全体が単一の DOMString
に収まらない場合は、実装の制限が有効になります。この場合、ユーザーは substringData
を呼び出し、データを適切なサイズに分割して取得できます。
DOMException
- NO_MODIFICATION_ALLOWED_ERR:ノードが読み取り専用の場合int getLength()
data
メソッドおよび substringData
メソッドを介して取得可能な 16 ビット単位の数です。CharacterData
ノードが空の場合、値はゼロになります。
String substringData(int offset, int count) throws DOMException
offset
- 抽出する部分文字列の開始オフセットcount
- 抽出する 16 ビット単位の数
offset
と
count
の合計が length
を超える場合、
データの末尾までに含まれるすべての 16 ビット単位が返される
DOMException
- INDEX_SIZE_ERR:指定された offset
が負の値であるか、data
内の 16 ビット単位の数より大きい場合。
または、指定された count
が負の値である
場合
DOMString
に収まらない場合void appendData(String arg) throws DOMException
data
により、指定された data
と DOMString
を連結したものにアクセスできます。
arg
- 追加される DOMString
DOMException
- NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用の場合void insertData(int offset, String arg) throws DOMException
offset
- 挿入位置の文字オフセットarg
- 挿入される DOMString
DOMException
- INDEX_SIZE_ERR:指定された offset
が負の値であるか、data
内の 16 ビット単位の数より大きい
場合
void deleteData(int offset, int count) throws DOMException
data
と length
に変更が反映されます。
offset
- 削除を開始する位置のオフセットcount
- 削除する 16 ビット単位の数。offset
と
count
の合計が
length
を超える場合、offset
からデータの末尾までに
存在するすべての 16 ビット単位が削除される
DOMException
- INDEX_SIZE_ERR:指定された offset
が負の値であるか、data
内の 16 ビット単位の数より大きい
場合。または、指定された count
が負の値である
場合
void replaceData(int offset, int count, String arg) throws DOMException
offset
- 置き換えを開始する位置のオフセットcount
- 置き換える 16 ビット単位の数。offset
と
count
の合計が
length
を超える場合、offset
からデータの末尾までに存在するすべての 16 ビット単位が
置き換えられる (その範囲に対して remove
メソッドと
append
メソッドを連続して呼び出した場合と
同じ結果)arg
- 所定の範囲と置き換えられる
DOMString
DOMException
- INDEX_SIZE_ERR:指定された offset
が負の値であるか、data
内の 16 ビット単位の数より大きい
場合。または、指定された count
が負の値である
場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。