Usage of nsIDOMRange Interface

 Evaluate FIXptr expression. FIXptr is a W3C NOTE, see

 http://lists.w3.org/Archives/Public/www-xml-linking-comments/2001AprJun/att-0074/01-NOTE-FIXptr-20010425.htm

 @param  expression FIXptr string.
 @return            The range object that results from evaluation

nsIDOMRange evaluateFIXptr(in DOMString expression)

 Evaluate a FIXptr expression.

 @param aDocument   The document in which to evaluate.
 @param aExpression The FIXptr expression string to evaluate.
 @return            The result.

nsIDOMRange evaluate(in nsIDOMDocument aDocument, in DOMString aExpression)

 Find some text in the current context. The implementation is
 responsible for performing the find and highlighting the text.

 @param aPatText     The text to search for.
 @param aSearchRange A Range specifying domain of search.
 @param aStartPoint  A Range specifying search start point.
                     If not collapsed, we'll start from
                     end (forward) or start (backward).
 @param aEndPoint    A Range specifying search end point.
                     If not collapsed, we'll end at
                     end (forward) or start (backward).
 @retval             A range spanning the match that was found (or null).

nsIDOMRange Find(in wstring aPatText, in nsIDOMRange aSearchRange, in nsIDOMRange aStartPoint, in nsIDOMRange aEndPoint)

 Returns the range at the specified index.

nsIDOMRange getRangeAt(in long index)

  If the range is set to a non-null value, then the
  range is used for encoding, otherwise the entire
  document or selection is encoded.
 @param aRange The range to encode.

void setRange(in nsIDOMRange aRange)

 Find some text in the current context. The implementation is
 responsible for performing the find and highlighting the text.

 @param aPatText     The text to search for.
 @param aSearchRange A Range specifying domain of search.
 @param aStartPoint  A Range specifying search start point.
                     If not collapsed, we'll start from
                     end (forward) or start (backward).
 @param aEndPoint    A Range specifying search end point.
                     If not collapsed, we'll end at
                     end (forward) or start (backward).
 @retval             A range spanning the match that was found (or null).

nsIDOMRange Find(in wstring aPatText, in nsIDOMRange aSearchRange, in nsIDOMRange aStartPoint, in nsIDOMRange aEndPoint)

 Find some text in the current context. The implementation is
 responsible for performing the find and highlighting the text.

 @param aPatText     The text to search for.
 @param aSearchRange A Range specifying domain of search.
 @param aStartPoint  A Range specifying search start point.
                     If not collapsed, we'll start from
                     end (forward) or start (backward).
 @param aEndPoint    A Range specifying search end point.
                     If not collapsed, we'll end at
                     end (forward) or start (backward).
 @retval             A range spanning the match that was found (or null).

nsIDOMRange Find(in wstring aPatText, in nsIDOMRange aSearchRange, in nsIDOMRange aStartPoint, in nsIDOMRange aEndPoint)

 Find some text in the current context. The implementation is
 responsible for performing the find and highlighting the text.

 @param aPatText     The text to search for.
 @param aSearchRange A Range specifying domain of search.
 @param aStartPoint  A Range specifying search start point.
                     If not collapsed, we'll start from
                     end (forward) or start (backward).
 @param aEndPoint    A Range specifying search end point.
                     If not collapsed, we'll end at
                     end (forward) or start (backward).
 @retval             A range spanning the match that was found (or null).

nsIDOMRange Find(in wstring aPatText, in nsIDOMRange aSearchRange, in nsIDOMRange aStartPoint, in nsIDOMRange aEndPoint)

 Adds a range to the current selection.

void addRange(in nsIDOMRange range)

 Removes a range from the current selection.

void removeRange(in nsIDOMRange range)

 Return array of ranges intersecting with the given DOM interval.

void GetRangesForInterval(in nsIDOMNode beginNode, in PRInt32 beginOffset, in nsIDOMNode endNode, in PRInt32 endOffset, in PRBool allowAdjacent, out PRUint32 resultCount, [array, retval, size_is(resultCount)] out nsIDOMRange results)

 Test if supplied range points to a single table element:
    Result is one of above constants. "None" means
    a table element isn't selected.

long getTableSelectionType(in nsIDOMRange range)

 Set the painting style for the range. The range must be a range in
 the selection. The textRangeStyle will be used by text frame
 when it is painting the selection.

[noscript] void setTextRangeStyle(in nsIDOMRange range, in constTextRangeStyleRef textRangeStyle)

 Get first selected element from first selection range.
   (If multiple cells were selected this is the first in the order they were selected)
 Assumes cell-selection model where each cell
 is in a separate range (selection parent node is table row)
 @param aCell     [OUT] Selected cell or null if ranges don't contain
                  cell selections
 @param aRange    [OUT] Optional: if not null, return the selection range 
                     associated with the cell
 Returns the DOM cell element
   (in C++: returns NS_EDITOR_ELEMENT_NOT_FOUND if an element is not found
    passes NS_SUCCEEDED macro)

nsIDOMElement getFirstSelectedCell(out nsIDOMRange aRange)

 Get next selected cell element from first selection range.
 Assumes cell-selection model where each cell
 is in a separate range (selection parent node is table row)
 Always call GetFirstSelectedCell() to initialize stored index of "next" cell
 @param aCell     Selected cell or null if no more selected cells
                     or ranges don't contain cell selections
 @param aRange    Optional: if not null, return the selection range 
                     associated with the cell

 Returns the DOM cell element
   (in C++: returns NS_EDITOR_ELEMENT_NOT_FOUND if an element is not found
    passes NS_SUCCEEDED macro)

nsIDOMElement getNextSelectedCell(out nsIDOMRange aRange)