Parameter syntax:
[ 'orParent' | 'extend' ]?
This command is used to implement the feature called "Add interactive margin to the styled view". See Section 5.5, “Edit options” in XMLmind XML Editor - Online Help.
Selects the ``block'' (paragraph, row, row group or table) on which the user has clicked. All graphical objects intersecting the Y coordinate of the mouse click are used to determine which block to select. The X coordinate of the mouse click is ignored.
This command can only be used in a styled view because a tree view does not contain ``blocks''.
If the orParent
option is specified, clicking again, exactly at the same place (i.e. without moving the mouse at all), selects the parent of the element selected by the previous invocation of this command.
If the extend
option is used and if there is a node selection, this command extends the selected node range by adding sibling nodes to it. The block clicked upon specifies how many sibling nodes are to be added.
See also selectNodeAt.