Диапазон (Общий API ДОМА b92)

```
public interface Range
```
См. также Объектную модель документа (ДОМ) Обход Уровня 2 и Спецификация Диапазона.

С тех пор:

ДОМ Левель 2

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static short`	`END_TO_END` Сравните граничную точку конца `sourceRange` закончить граничную точку Диапазона на который `compareBoundaryPoints` вызывается.
`static short`	`END_TO_START` Сравните граничную точку конца `sourceRange` запустить граничную точку Диапазона на который `compareBoundaryPoints` вызывается.
`static short`	`START_TO_END` Сравнитесь запускают граничную точку `sourceRange` закончить граничную точку Диапазона на который `compareBoundaryPoints` вызывается.
`static short`	`START_TO_START` Сравнитесь запускают граничную точку `sourceRange` запустить граничную точку Диапазона на который `compareBoundaryPoints` вызывается.

Сводка метода

Все Методы Методы экземпляра Абстрактные Методы
Модификатор и Тип	Метод и Описание
`DocumentFragment`	`cloneContents()` Копирует содержание Диапазона
`Диапазон`	`cloneRange()` Производит новый Диапазон, граничные точки которого равны граничным точкам Диапазона.
`void`	`collapse(boolean toStart)` Сверните Диапазон на одну из его граничных точек
`short`	`compareBoundaryPoints(short how, Range sourceRange)` Сравните граничные точки двух Диапазонов в документе.
`void`	`deleteContents()` Удаляет содержание Диапазона от содержания документа или фрагмента документа, не возвращая ссылку на удаленный контент.
`void`	`detach()` Вызванный, чтобы указать, что Диапазон больше не находится в использовании и что реализация может оставить любые ресурсы, связанные с этим Диапазоном.
`DocumentFragment`	`extractContents()` Перемещает содержание Диапазона от содержания документа или фрагмента документа в новый DocumentFragment.
`boolean`	`getCollapsed()` ИСТИНА, если Диапазон сворачивается
`Узел`	`getCommonAncestorContainer()` Самый глубокий контейнер общего предка двух граничных точек Диапазона.
`Узел`	`getEndContainer()` Узел, в пределах которого заканчивается Диапазон
`int`	`getEndOffset()` Смещение в пределах конечного узла Диапазона.
`Узел`	`getStartContainer()` Узел, в пределах которого начинается Диапазон
`int`	`getStartOffset()` Смещение в пределах запускающегося узла Диапазона.
`void`	`insertNode(Node newNode)` Вставляет узел в Документ или DocumentFragment в начале Диапазона.
`void`	`selectNode(Node refNode)` Выберите узел и его содержание
`void`	`selectNodeContents(Node refNode)` Выберите содержание в пределах узла
`void`	`setEnd(Node refNode, int offset)` Устанавливает атрибуты, описывающие конец Диапазона.
`void`	`setEndAfter(Node refNode)` Устанавливает конец Диапазона, чтобы быть после узла
`void`	`setEndBefore(Node refNode)` Устанавливает позицию конца, чтобы быть перед узлом.
`void`	`setStart(Node refNode, int offset)` Устанавливает атрибуты, описывающие запуск Диапазона.
`void`	`setStartAfter(Node refNode)` Устанавливает позицию запуска, чтобы быть после узла
`void`	`setStartBefore(Node refNode)` Устанавливает позицию запуска, чтобы быть перед узлом
`void`	`surroundContents(Node newParent)` Повторно порождает содержание Диапазона к данному узлу и вставляет узел в позиции запуска Диапазона.
`Строка`	`toString()` Возвращает содержание Диапазона как строка.

- Полевая Деталь
  - START_TO_START
```
static final short START_TO_START
```
    Сравнитесь запускают граничную точку sourceRange запустить граничную точку Диапазона на который compareBoundaryPoints вызывается.
    
    См. Также:
    
    Постоянные Значения полей
  - START_TO_END
```
static final short START_TO_END
```
    Сравнитесь запускают граничную точку sourceRange закончить граничную точку Диапазона на который compareBoundaryPoints вызывается.
    
    См. Также:
    
    Постоянные Значения полей
  - END_TO_END
```
static final short END_TO_END
```
    Сравните граничную точку конца sourceRange закончить граничную точку Диапазона на который compareBoundaryPoints вызывается.
    
    См. Также:
    
    Постоянные Значения полей
  - END_TO_START
```
static final short END_TO_START
```
    Сравните граничную точку конца sourceRange запустить граничную точку Диапазона на который compareBoundaryPoints вызывается.
    
    См. Также:
    
    Постоянные Значения полей
- Деталь метода
  - getStartContainer
```
Node getStartContainer()
                throws DOMException
```
    Узел, в пределах которого начинается Диапазон
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - getStartOffset
```
int getStartOffset()
            throws DOMException
```
    Смещение в пределах запускающегося узла Диапазона.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - getEndContainer
```
Node getEndContainer()
              throws DOMException
```
    Узел, в пределах которого заканчивается Диапазон
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - getEndOffset
```
int getEndOffset()
          throws DOMException
```
    Смещение в пределах конечного узла Диапазона.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - getCollapsed
```
boolean getCollapsed()
              throws DOMException
```
    ИСТИНА, если Диапазон сворачивается
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - getCommonAncestorContainer
```
Node getCommonAncestorContainer()
                         throws DOMException
```
    Самый глубокий контейнер общего предка двух граничных точек Диапазона.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - setStart
```
void setStart(Node refNode,
              int offset)
       throws RangeException,
              DOMException
```
    Устанавливает атрибуты, описывающие запуск Диапазона.
    
    Параметры:
    
    refNode - refNode значение. Этот параметр должен отличаться от null.
    
    offset - startOffset значение.
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если refNode или предок refNode Объект, Нотация, или узел DocumentType.
    
    DOMException - INDEX_SIZE_ERR: Повышенный, если offset отрицательно или больше чем число дочерних модулей в refNode. Дочерние модули являются 16-разрядными модулями если refNode тип узла CharacterData (например, узла текста или Комментария) или узла ProcessingInstruction. Дочерними модулями являются Узлы во всех других случаях.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - setEnd
```
void setEnd(Node refNode,
            int offset)
     throws RangeException,
            DOMException
```
    Устанавливает атрибуты, описывающие конец Диапазона.
    
    Параметры:
    
    refNode - refNode значение. Этот параметр должен отличаться от null.
    
    offset - endOffset значение.
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если refNode или предок refNode Объект, Нотация, или узел DocumentType.
    
    DOMException - INDEX_SIZE_ERR: Повышенный, если offset отрицательно или больше чем число дочерних модулей в refNode. Дочерние модули являются 16-разрядными модулями если refNode тип узла CharacterData (например, узла текста или Комментария) или узла ProcessingInstruction. Дочерними модулями являются Узлы во всех других случаях.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - setStartBefore
```
void setStartBefore(Node refNode)
             throws RangeException,
                    DOMException
```
    Устанавливает позицию запуска, чтобы быть перед узлом
    
    Параметры:
    
    refNode - Диапазон запускается прежде refNode
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если корневой контейнер refNode не Attr, Документ, или узел DocumentFragment или если refNode Документ, DocumentFragment, Attr, Объект, или узел Нотации.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - setStartAfter
```
void setStartAfter(Node refNode)
            throws RangeException,
                   DOMException
```
    Устанавливает позицию запуска, чтобы быть после узла
    
    Параметры:
    
    refNode - Диапазон запускается после refNode
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если корневой контейнер refNode не Attr, Документ, или узел DocumentFragment или если refNode Документ, DocumentFragment, Attr, Объект, или узел Нотации.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - setEndBefore
```
void setEndBefore(Node refNode)
           throws RangeException,
                  DOMException
```
    Устанавливает позицию конца, чтобы быть перед узлом.
    
    Параметры:
    
    refNode - Концы диапазона прежде refNode
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если корневой контейнер refNode не Attr, Документ, или узел DocumentFragment или если refNode Документ, DocumentFragment, Attr, Объект, или узел Нотации.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - setEndAfter
```
void setEndAfter(Node refNode)
          throws RangeException,
                 DOMException
```
    Устанавливает конец Диапазона, чтобы быть после узла
    
    Параметры:
    
    refNode - Концы диапазона после refNode.
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если корневой контейнер refNode не Attr, Документ или узел DocumentFragment или если refNode Документ, DocumentFragment, Attr, Объект, или узел Нотации.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - коллапс
```
void collapse(boolean toStart)
       throws DOMException
```
    Сверните Диапазон на одну из его граничных точек
    
    Параметры:
    
    toStart - ЕСЛИ ЭТО ПРАВДА, сворачивает Диапазон на его запуск; если ЛОЖЬ, коллапсы это на ее конец.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - selectNode
```
void selectNode(Node refNode)
         throws RangeException,
                DOMException
```
    Выберите узел и его содержание
    
    Параметры:
    
    refNode - Узел, чтобы выбрать.
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если предок refNode Объект, Нотация или узел DocumentType или если refNode Документ, DocumentFragment, Attr, Объект, или узел Нотации.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - selectNodeContents
```
void selectNodeContents(Node refNode)
                 throws RangeException,
                        DOMException
```
    Выберите содержание в пределах узла
    
    Параметры:
    
    refNode - Узел, чтобы выбрать из
    
    Броски:
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если refNode или предок refNode Объект, Нотация или узел DocumentType.
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    WRONG_DOCUMENT_ERR: Повышенный, если refNode создавался из различного документа чем тот, который создал этот диапазон.
  - compareBoundaryPoints
```
short compareBoundaryPoints(short how,
                            Range sourceRange)
                     throws DOMException
```
    Сравните граничные точки двух Диапазонов в документе.
    
    Параметры:
    
    how - Код, представляющий тип сравнения, как определено выше.
    
    sourceRange - Range на котором этот ток Range по сравнению с.
    
    Возвраты:
    
    -1, 0 или 1 в зависимости от того, является ли соответствующая граничная точка Диапазона соответственно прежде, равной, или после соответствующей граничной точки sourceRange.
    
    Броски:
    
    DOMException - WRONG_DOCUMENT_ERR: Повышенный, если два Диапазона не находятся в том же самом Документе или DocumentFragment.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - deleteContents
```
void deleteContents()
             throws DOMException
```
    Удаляет содержание Диапазона от содержания документа или фрагмента документа, не возвращая ссылку на удаленный контент.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если какая-либо часть контента Диапазона только для чтения или какой-либо из узлов, которые содержат любой контент Диапазона, только для чтения.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - extractContents
```
DocumentFragment extractContents()
                          throws DOMException
```
    Перемещает содержание Диапазона от содержания документа или фрагмента документа в новый DocumentFragment.
    
    Возвраты:
    
    DocumentFragment, содержащий извлеченное содержание.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если какая-либо часть контента Диапазона только для чтения или какой-либо из узлов, которые содержат любой контент Диапазона, только для чтения.
    HIERARCHY_REQUEST_ERR: Повышенный, если узел DocumentType был бы извлечен в новый DocumentFragment.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - cloneContents
```
DocumentFragment cloneContents()
                        throws DOMException
```
    Копирует содержание Диапазона
    
    Возвраты:
    
    DocumentFragment, который содержит контент, эквивалентный этому Диапазону.
    
    Броски:
    
    DOMException - HIERARCHY_REQUEST_ERR: Повышенный, если узел DocumentType был бы извлечен в новый DocumentFragment.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - insertNode
```
void insertNode(Node newNode)
         throws DOMException,
                RangeException
```
    Вставляет узел в Документ или DocumentFragment в начале Диапазона. Если контейнер будет текстовым узлом, то это будет разделено в начале Диапазона (как будто splitText метод узла текста выполнялся в точке вставки), и вставка произойдет между двумя получающимися текстовыми узлами. Смежные текстовые узлы не будут автоматически объединены. Если узел, который будет вставлен, будет узлом DocumentFragment, то дочерние элементы будут введены, а не узел DocumentFragment непосредственно.
    
    Параметры:
    
    newNode - Узел, чтобы вставить в начале Диапазона
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если контейнер предка запуска Диапазона только для чтения.
    WRONG_DOCUMENT_ERR: Повышенный, если newNode и контейнер запуска Диапазона не создавался из того же самого документа.
    HIERARCHY_REQUEST_ERR: Повышенный, если контейнер запуска Диапазона имеет тип, который не позволяет дочерним элементам типа newNode или если newNode предок контейнера.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    
    RangeException - INVALID_NODE_TYPE_ERR: Повышенный, если newNode Attr, Объект, Нотация, или узел Документа.
  - surroundContents
```
void surroundContents(Node newParent)
               throws DOMException,
                      RangeException
```
    Повторно порождает содержание Диапазона к данному узлу и вставляет узел в позиции запуска Диапазона.
    
    Параметры:
    
    newParent - Узел, чтобы окружить содержание.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если контейнер предка любой граничной точки Диапазона только для чтения.
    WRONG_DOCUMENT_ERR: Повышенный, если newParent и контейнер запуска Диапазона не создавался из того же самого документа.
    HIERARCHY_REQUEST_ERR: Повышенный, если контейнер запуска Диапазона имеет тип, который не позволяет дочерним элементам типа newParent или если newParent предок контейнера или если node закончился бы с дочерним узлом типа, не позволенного типом node.
    INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
    
    RangeException - BAD_BOUNDARYPOINTS_ERR: Повышенный, если Диапазон частично выбирает нетекстовый узел.
    INVALID_NODE_TYPE_ERR: Повышенный, если node Attr, Объект, DocumentType, Нотация, Документ, или узел DocumentFragment.
  - cloneRange
```
Range cloneRange()
          throws DOMException
```
    Производит новый Диапазон, граничные точки которого равны граничным точкам Диапазона.
    
    Возвраты:
    
    Дублированный Диапазон.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - toString
```
String toString()
         throws DOMException
```
    Возвращает содержание Диапазона как строка. Эта строка содержит только символы данных, не любую разметку.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    Содержание Диапазона.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.
  - отсоединение
```
void detach()
     throws DOMException
```
    Вызванный, чтобы указать, что Диапазон больше не находится в использовании и что реализация может оставить любые ресурсы, связанные с этим Диапазоном. Последующие звонки в любые методы или методов get атрибута на этом Диапазоне приведут к a DOMException будучи брошенным с кодом ошибки INVALID_STATE_ERR.
    
    Броски:
    
    DOMException - INVALID_STATE_ERR: Повышенный, если detach() был уже вызван на этот объект.

Представьте ошибку или функцию
Java является торговой маркой или зарегистрированной торговой маркой Oracle и/или его филиалов в US и других странах.
Авторское право © 2005, 2013, Oracle и/или его филиалы. 500 Бульваров Oracle
Берега красного дерева, Калифорния 94065 США. Все права защищены.
Проект сборка-b92

Диапазон интерфейса

Полевая Сводка

Сводка метода

Полевая Деталь

START_TO_START

START_TO_END

END_TO_END

END_TO_START

Деталь метода

getStartContainer

getStartOffset

getEndContainer

getEndOffset

getCollapsed

getCommonAncestorContainer

setStart

setEnd

setStartBefore

setStartAfter

setEndBefore

setEndAfter

коллапс

selectNode

selectNodeContents

compareBoundaryPoints

deleteContents

extractContents

cloneContents

insertNode

surroundContents

cloneRange

toString

отсоединение