/ 
Mozilla-DOM-0.18
River stage two • 3 direct dependents • 10 total dependents
/ Mozilla::DOM::Selection

NAME

Mozilla::DOM::Selection

Mozilla::DOM::Selection is a wrapper around an instance of Mozilla's nsISelection interface. This class inherits from Supports.

* Interface for manipulating and querying the current selected range
* of nodes within the document.

CLASS METHODS

$iid = Mozilla::DOM::Selection->GetIID()

Pass this to QueryInterface.

METHODS

$selection->AddRange($range)

    • $range (Mozilla::DOM::Range)

    * Adds a range to the current selection.

$selection->Collapse($parentNode, $offset)

    • $parentNode (Mozilla::DOM::Node)

    • $offset (integer (long))

    * Collapses the selection to a single point, at the specified offset
* in the given DOM node. When the selection is collapsed, and the content
* is focused and editable, the caret will blink there.
*
* @param parentNode      The given dom node where the selection will be set
* @param offset          Where in given dom node to place the selection
                         (the offset into the given node)

$selection->CollapseToStart()

    * Collapses the whole selection to a single point at the start
* of the current selection (irrespective of direction).  If content
* is focused and editable, the caret will blink there.

$selection->CollapseToEnd()

    * Collapses the whole selection to a single point at the end
* of the current selection (irrespective of direction).  If content
* is focused and editable, the caret will blink there.

$bool = $selection->ContainsNode($node, $entirelyContained)

    • $node (Mozilla::DOM::Node)

    • $entirelyContained (boolean)

    * The value of entirelyContained determines the detail of the search to determine if
* the selection contains the node.  If entirelyContained is set to PR_TRUE, t
* or false if
*
* @param node      The node where the selection will be extended to
* @param entirelyContained Whether

$selection->DeleteFromDocument()

    * Deletes this selection from document the nodes belong to.

$selection->Extend($parentNode, $offset)

    • $parentNode (Mozilla::DOM::Node)

    • $offset (integer (long))

    * Extends the selection by moving the focus to the specified node and offset,
* preserving the anchor postion.  The new selection end result will always
* be from the anchor to the new focus, regardless of direction.
*
* @param parentNode      The node where the selection will be extended to
* @param offset          Where in node to place the offset in the new focused node

$node = $selection->GetAnchorNode()

    * The node representing one end of the selection.

$offset = $selection->GetAnchorOffset()

    * The offset within the (text) node where the selection begins.

$node = $selection->GetFocusNode()

    * The node with keyboard focus.

$offset = $selection->GetFocusOffset()

    * The offset within the (text) node where focus starts.

$bool = $selection->GetIsCollapsed()

    * Indicates if the selection is collapsed or not.

$range = $selection->GetRangeAt($index)

    • $index (integer (long))

    * Returns the range at the specified index.

$count = $selection->GetRangeCount()

    * Returns the number of ranges in the selection.

$selection->RemoveAllRanges()

    * Removes all ranges from the current selection.

$selection->RemoveRange($range)

    • $range (Mozilla::DOM::Range)

    * Removes a range from the current selection.

$selection->SelectAllChildren($parentnode)

    • $parentNode (Mozilla::DOM::Node)

    * Adds all children of the specified node to the selection.
*
* @param parentNode  the parent of the children to be added to the selection.

$selection->SelectionLanguageChange($langRTL)

    • $langRTL (boolean)

    * Modifies the cursor Bidi level after a change in keyboard direction
*
* @param langRTL is PR_TRUE if the new language is right-to-left or
*                PR_FALSE if the new language is left-to-right.

$str = $selection->ToString()

    Returns the whole selection into a plain text string. Note: only the text, not the markup. (DAMN!)

SEE ALSO

Mozilla::DOM

COPYRIGHT

Copyright (C) 2005, Scott Lanning

This software is licensed under the LGPL. See Mozilla::DOM for a full notice.