選択科目
プログラミング
XML DOM compareBoundaryPoints() メソッド
定義と使用法
compareBoundaryPoints() メソッドは二つの範囲の位置を比較します。how文法：sourceRangecompareBoundaryPoints(
,
| , | 説明 |
|---|---|
| how | ) |
| sourceRange | パラメータ |
比較操作を実行する方法を宣言します（即ち、比較する境界点）。その正当な値は Range インターフェースで定義された定数です。
返り値 sourceRange 現在の範囲の指定された境界点が sourceRange 指定された境界点以前に投げ出された場合、-1を返します。指定された二つの境界点が同じ場合、0を返します。現在の範囲の境界点が
指定された境界点以降に投げ出された場合、1を返します。
もし sourceRange は、現在の範囲が示すドキュメントと指定されたドキュメントが異なる場合、WRONG_DOCUMENT_ERR コードでエラーを投げ出します。 DOMException 异常。
説明
このメソッドは、現在の範囲の境界ポイントと指定された sourceRange の境界ポイントを比較し、それらがソースドキュメント内での相対的な位置を示す値を返します。パラメータ how を比較するための境界ポイントを指定します。このパラメータの有効な値とその意味は以下の通りです：
- Range.START_TO_START - 2つの Range ノードの開始ポイントを比較します
- Range.END_TO_END - 2つの Range ノードの終了ポイントを比較します
- Range.START_TO_END - sourceRange の開始ポイントと現在の範囲の終了ポイントを比較します
- Range.END_TO_START - sourceRange の終了ポイントと現在の範囲の開始ポイントを比較します
このメソッドの返値は数字で、現在の範囲がどの程度の位置にいるかを示します sourceRange の位置。したがって、まずこのパラメータを使って how の範囲定数は、現在の範囲の境界ポイントを指定し、それを使って sourceRange の境界ポイント。しかし実際には、定数 Range.START_TO_END は、現在の範囲の end ポイントと sourceRange の start ポイントと比較します。同様に、定数 Range.END_TO_START は、現在の範囲の start ポイントと指定された範囲の end ポイントを比較することを指定します。
