public interface Range
修飾子と型 | フィールドと説明 |
---|---|
static short |
END_TO_END
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。 |
static short |
END_TO_START
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。 |
static short |
START_TO_END
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。 |
static short |
START_TO_START
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。 |
修飾子と型 | メソッドと説明 |
---|---|
DocumentFragment |
cloneContents()
Range の内容を複製します。
|
Range |
cloneRange()
この Range の境界点と同等の境界点を持つ新規 Range を作成します。
|
void |
collapse(boolean toStart)
境界点の 1 つに Range を折りたたみます。
|
short |
compareBoundaryPoints(short how, Range sourceRange)
ドキュメントの 2 つの Range の境界点を比較します。
|
void |
deleteContents()
削除された内容への参照を返すことなく、含まれているドキュメントまたはドキュメントのフラグメントから Range の内容を削除します。
|
void |
detach()
Range が使用されなくなったことと、実装がこの Range に関連するリソースを放棄してもかまわないことを示すために呼び出されます。
|
DocumentFragment |
extractContents()
含まれているドキュメントまたはドキュメントのフラグメントから Range の内容を移動します。
|
boolean |
getCollapsed()
Range が折りたたまれている場合は true。
|
Node |
getCommonAncestorContainer()
Range の 2 つの境界点のもっとも深い共通上位コンテナ。
|
Node |
getEndContainer()
内部で Range が終了するノード。
|
int |
getEndOffset()
Range の終了ノード内のオフセット。
|
Node |
getStartContainer()
内部で Range が始まるノード。
|
int |
getStartOffset()
Range の開始ノード内のオフセット。
|
void |
insertNode(Node newNode)
ノードを Document または DocumentFragment の Range の開始位置に挿入します。
|
void |
selectNode(Node refNode)
ノードとその内容を選択します。
|
void |
selectNodeContents(Node refNode)
ノード内の内容を選択します。
|
void |
setEnd(Node refNode, int offset)
Range の終了を記述する属性を設定します。
|
void |
setEndAfter(Node refNode)
Range の終了をノードのあとに設定します。
|
void |
setEndBefore(Node refNode)
終了位置をノードの前に設定します。
|
void |
setStart(Node refNode, int offset)
Range の開始を記述する属性を設定します。
|
void |
setStartAfter(Node refNode)
開始位置をノードのあとに設定します。
|
void |
setStartBefore(Node refNode)
開始位置をノードの前に設定します。
|
void |
surroundContents(Node newParent)
Range の内容を所定のノードの親として再設定し、再設定したノードを Range の開始位置に挿入します。
|
String |
toString()
Range の内容を文字列として返します。
|
static final short START_TO_START
sourceRange
の開始境界点と compareBoundaryPoints
が呼び出される Range の開始境界点を比較します。static final short START_TO_END
sourceRange
の開始境界点と compareBoundaryPoints
が呼び出される Range の終了境界点を比較します。static final short END_TO_END
sourceRange
の終了境界点と compareBoundaryPoints
が呼び出される Range の終了境界点を比較します。static final short END_TO_START
sourceRange
の終了境界点と compareBoundaryPoints
が呼び出される Range の開始境界点を比較します。Node getStartContainer() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。int getStartOffset() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。Node getEndContainer() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。int getEndOffset() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。boolean getCollapsed() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。Node getCommonAncestorContainer() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。void setStart(Node refNode, int offset) throws RangeException, DOMException
refNode
- refNode
値。このパラメータは null
以外でなければならない。offset
- startOffset
値。RangeException
- INVALID_NODE_TYPE_ERR: refNode
または refNode
の上位が Entity、Notation、または DocumentType ノードの場合に発生する。DOMException
- INDEX_SIZE_ERR: offset
が負であるか、refNode
の子の単位数よりも大きい場合に発生する。refNode
が CharacterData ノード (Text または Comment ノードなど) または ProcessingInstruction ノードの型の場合、子の単位は 16 ビット単位である。ほかのすべてのケースで、子の単位は Nodes であるdetach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void setEnd(Node refNode, int offset) throws RangeException, DOMException
refNode
- refNode
値。このパラメータは null
以外でなければならない。offset
- endOffset
値。RangeException
- INVALID_NODE_TYPE_ERR: refNode
または refNode
の上位が Entity、Notation、または DocumentType ノードの場合に発生する。DOMException
- INDEX_SIZE_ERR: offset
が負であるか、refNode
の子の単位数よりも大きい場合に発生する。refNode
が CharacterData ノード (Text または Comment ノードなど) または ProcessingInstruction ノードの型の場合、子の単位は 16 ビット単位である。ほかのすべてのケースで、子の単位は Nodes であるdetach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void setStartBefore(Node refNode) throws RangeException, DOMException
refNode
- Range は refNode
の前から始まるRangeException
- INVALID_NODE_TYPE_ERR: refNode
が Attr、Document、または DocumentFragment ノードではない場合、または refNode
が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void setStartAfter(Node refNode) throws RangeException, DOMException
refNode
- Range は refNode
のあとから始まるRangeException
- INVALID_NODE_TYPE_ERR: refNode
が Attr、Document、または DocumentFragment ノードではない場合、または refNode
が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void setEndBefore(Node refNode) throws RangeException, DOMException
refNode
- Range は refNode
の前で終わるRangeException
- INVALID_NODE_TYPE_ERR: refNode
が Attr、Document、または DocumentFragment ノードではない場合、または refNode
が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void setEndAfter(Node refNode) throws RangeException, DOMException
refNode
- Range は refNode
のあとで終わる。RangeException
- INVALID_NODE_TYPE_ERR: refNode
が Attr、Document、または DocumentFragment ノードではない場合、または refNode
が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void collapse(boolean toStart) throws DOMException
toStart
- true の場合、Range を開始境界点に折りたたみ、false の場合、終了境界点に折りたたむ。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。void selectNode(Node refNode) throws RangeException, DOMException
refNode
- 選択するノード。RangeException
- INVALID_NODE_TYPE_ERR: refNode
の上位が Entity、Notation、または DocumentType ノードの場合、または refNode
が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。void selectNodeContents(Node refNode) throws RangeException, DOMException
refNode
- 内容が選択されるノードRangeException
- INVALID_NODE_TYPE_ERR: refNode
または refNode
の上位が Entity、Notation、または DocumentType ノードの場合に発生する。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。refNode
が、この範囲を作成したドキュメントとは異なるドキュメントから作成された場合に発生する。short compareBoundaryPoints(short how, Range sourceRange) throws DOMException
how
- 前述のように比較の種類を表すコード。sourceRange
- 現在の Range
の比較対象の Range
。sourceRange
の対応する境界点の前、同等、またはあとかに応じて、それぞれ -1、0、または 1。DOMException
- WRONG_DOCUMENT_ERR: 2 つの Range が同じ Document または DocumentFragment にない場合に発生する。detach()
が呼び出されている場合に発生する。void deleteContents() throws DOMException
DOMException
- NO_MODIFICATION_ALLOWED_ERR: Range の内容の一部が読み取り専用の場合、または Range の内容を含むノードのいずれかが読み取り専用の場合に発生する。detach()
が呼び出されている場合に発生する。DocumentFragment extractContents() throws DOMException
DOMException
- NO_MODIFICATION_ALLOWED_ERR: Range の内容の一部が読み取り専用の場合、または Range の内容を含むノードのいずれかが読み取り専用の場合に発生するdetach()
が呼び出されている場合に発生する。DocumentFragment cloneContents() throws DOMException
DOMException
- HIERARCHY_REQUEST_ERR: DocumentType ノードが新しい DocumentFragment に抽出される場合に発生するdetach()
が呼び出されている場合に発生する。void insertNode(Node newNode) throws DOMException, RangeException
newNode
- Range の開始位置に挿入されるノードDOMException
- NO_MODIFICATION_ALLOWED_ERR: Range の開始の上位コンテナが読み取り専用の場合に発生する。newNode
および Range の開始のコンテナが同じドキュメントから作成されていなかった場合に発生する。newNode
の型の子を許可しない型のコンテナの場合、または newNode
がコンテナの上位である場合に発生する。detach()
が呼び出されている場合に発生する。RangeException
- INVALID_NODE_TYPE_ERR: newNode
が Attr、Entity、Notation、または Document ノードの場合に発生する。void surroundContents(Node newParent) throws DOMException, RangeException
newParent
- 内容を囲むノード。DOMException
- NO_MODIFICATION_ALLOWED_ERR: Range のどちらかの境界点の上位コンテナが読み取り専用の場合に発生する newParent
および Range の開始のコンテナが同じドキュメントから作成されていなかった場合に発生する。newParent
の型の子を許可しない型のコンテナである場合、または newParent
がコンテナの上位の場合、あるいは node
が、node
の型によって許可されていない型の子ノードで終わる場合に発生する。detach()
が呼び出されている場合に発生する。RangeException
- BAD_BOUNDARYPOINTS_ERR: Range が部分的にテキスト以外のノードを選択した場合に発生する node
が Attr、Entity、DocumentType、Notation、Document、または DocumentFragment ノードの場合に発生する。Range cloneRange() throws DOMException
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。String toString() throws DOMException
toString
、クラス: Object
DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。void detach() throws DOMException
INVALID_STATE_ERR
で DOMException
がスローされます。DOMException
- INVALID_STATE_ERR: このオブジェクト上ですでに detach()
が呼び出されている場合に発生する。 バグまたは機能を送信
Java は米国ならびにその他の国における Oracle Corporation およびその関連企業の商標または登録商標です。
Copyright © 2005, 2013, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.