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.

cpanm Mozilla::DOM

perl -MCPAN -e shell
install Mozilla::DOM