dom/ranges/Range.java

49  * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>.
52 public interface Range {
54      * Node within which the Range begins
63      * Offset within the starting node of the Range.
72      * Node within which the Range ends
81      * Offset within the ending node of the Range.
90      * TRUE if the Range is collapsed
99      * The deepest common ancestor container of the Range's two
109      * Sets the attributes describing the start of the Range.
133      * Sets the attributes describing the end of a Range.
158      * @param refNode Range starts before <code>refNode</code>
175      * @param refNode Range starts after <code>refNode</code>
192      * @param refNode Range ends before <code>refNode</code>
208      * Sets the end of a Range to be after a node
209      * @param refNode Range ends after <code>refNode</code>.
225      * Collapse a Range onto one of its boundary-points
226      * @param toStart If TRUE, collapses the Range onto its start; if FALSE,
270      * boundary-point of Range on which <code>compareBoundaryPoints</code>
276      * boundary-point of Range on which <code>compareBoundaryPoints</code>
282      * boundary-point of Range on which <code>compareBoundaryPoints</code>
288      * boundary-point of Range on which <code>compareBoundaryPoints</code>
297      * @param sourceRange The <code>Range</code> on which this current
298      *   <code>Range</code> is compared to.
300      *   boundary-point of the Range is respectively before, equal to, or
309                                        Range sourceRange)
313      * Removes the contents of a Range from the containing document or
318      *   the Range is read-only or any of the nodes that contain any of the
319      *   content of the Range are read-only.
327      * Moves the contents of a Range from the containing document or document
332      *   the Range is read-only or any of the nodes which contain any of the
333      *   content of the Range are read-only.
343      * Duplicates the contents of a Range
345      *   Range.
357      * the Range. If the container is a Text node, this will be split at the
358      * start of the Range (as if the Text node's splitText method was
364      * @param newNode The node to insert at the start of the Range
367      *   start of the Range is read-only.
369      *   container of the start of the Range were not created from the same
372      *   the Range is of a type that does not allow children of the type of
385      * Reparents the contents of the Range to the given node and inserts the
386      * node at the position of the start of the Range.
390      *   either boundary-point of the Range is read-only.
392      *   container of the start of the Range were not created from the same
395      *   the Range is of a type that does not allow children of the type of
402      *   BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a
411      * Produces a new Range whose boundary-points are equal to the
412      * boundary-points of the Range.
413      * @return The duplicated Range.
418     public Range cloneRange()
422      * Returns the contents of a Range as a string. This string contains only
424      * @return The contents of the Range.
433      * Called to indicate that the Range is no longer in use and that the
435      * Range. Subsequent calls to any methods or attribute getters on this
436      * Range will result in a <code>DOMException</code> being thrown with an