Packageflashx.textLayout.edit
Interfacepublic interface ISelectionManager extends IInteractionEventHandler
Implementors SelectionManager

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The ISelectionManager interface defines the interface for handling text selection.

A SelectionManager keeps track of the selected text range and handles events for a TextFlow.

A selection can be either a point selection or a range selection. A point selection is the insertion point and is indicated visually by drawing a cursor. A range selection includes the text between an anchor point and an active point.

See also

flashx.textLayout.edit.SelectionManager
flashx.textLayout.edit.TextScrap
flashx.textLayout.elements.TextFlow


Public Properties
 PropertyDefined By
  absoluteEnd : int
[read-only] The text position of the end of the selection, as an offset from the start of the text flow.
ISelectionManager
  absoluteStart : int
[read-only] The text position of the start of the selection, as an offset from the start of the text flow.
ISelectionManager
  activeCellPosition : CellCoordinates
Active end of the current cell selection, as coordinates within the table.
ISelectionManager
  activePosition : int
[read-only] The active point of the selection.
ISelectionManager
  anchorCellPosition : CellCoordinates
Anchor point of the current cell selection, as coordinates within the table.
ISelectionManager
  anchorPosition : int
[read-only] The anchor point of the selection.
ISelectionManager
  currentCellSelectionFormat : SelectionFormat
[read-only] The current Cell SelectionFormat object.
ISelectionManager
  currentSelectionFormat : SelectionFormat
[read-only] The current SelectionFormat object.
ISelectionManager
  currentTable : TableElement
ISelectionManager
  editingMode : String
[read-only] The editing mode.
ISelectionManager
  focused : Boolean
[read-only] Indicates whether a container in the text flow has the focus.
ISelectionManager
  focusedCellSelectionFormat : SelectionFormat
The SelectionFormat object used to draw cell selections in a focused container.
ISelectionManager
  focusedSelectionFormat : SelectionFormat
The SelectionFormat object used to draw the selection in a focused container.
ISelectionManager
  inactiveCellSelectionFormat : SelectionFormat
The SelectionFormat object used to draw cell selections when they are not in the active window.
ISelectionManager
  inactiveSelectionFormat : SelectionFormat
The SelectionFormat object used to draw the selection when it is not in the active window.
ISelectionManager
  selectionType : String
[read-only] Indicates the type of selection.
ISelectionManager
  subManager : ISelectionManager
The ISelectionManager object used to for cell selections nested within the TextFlow managed by this ISelectionManager.
ISelectionManager
  superManager : ISelectionManager
The ISelectionManager object used to manage the parent TextFlow of this ISelectionManager (i.e.
ISelectionManager
  textFlow : TextFlow
The TextFlow object managed by this selection manager.
ISelectionManager
  unfocusedCellSelectionFormat : SelectionFormat
The SelectionFormat object used to draw cell selections when they are not in a focused container, but are in the active window.
ISelectionManager
  unfocusedSelectionFormat : SelectionFormat
The SelectionFormat object used to draw the selection when it is not in a focused container, but is in the active window.
ISelectionManager
  windowActive : Boolean
[read-only] Indicates whether the window associated with the text flow is active.
ISelectionManager
Public Methods
 MethodDefined By
 Inherited
activateHandler(event:Event):void
Processes an activate event.
IInteractionEventHandler
  
Clears the selection shapes.
ISelectionManager
 Inherited
deactivateHandler(event:Event):void
Processes a deactivate event.
IInteractionEventHandler
  
deselect():void
Removes any selection from the text flow
ISelectionManager
 Inherited
editHandler(event:Event):void
Processes an edit event.
IInteractionEventHandler
  
Executes any pending FlowOperations.
ISelectionManager
 Inherited
focusChangeHandler(event:FocusEvent):void
Processes a focusChange event.
IInteractionEventHandler
 Inherited
focusInHandler(event:FocusEvent):void
Processes a focusIn event.
IInteractionEventHandler
 Inherited
focusOutHandler(event:FocusEvent):void
Processes a focusOut event.
IInteractionEventHandler
  
ISelectionManager
  
Gets the character format attributes that are common to all characters in the specified text range or current selection.
ISelectionManager
  
Gets the container format attributes that are common to all containers in the specified text range or current selection.
ISelectionManager
  
Gets the paragraph format attributes that are common to all paragraphs in the specified text range or current selection.
ISelectionManager
  
Gets the SelectionState object of the current selection.
ISelectionManager
  
hasAnySelection():Boolean
Indicates whether there is a text or cell selection.
ISelectionManager
  
ISelectionManager
  
hasSelection():Boolean
Indicates whether there is a text selection.
ISelectionManager
 Inherited
imeStartCompositionHandler(event:IMEEvent):void
Processes an imeStartComposition event
IInteractionEventHandler
  
Indicates whether the selection covers a range of text.
ISelectionManager
 Inherited
keyDownHandler(event:KeyboardEvent):void
Processes a keyDown event.
IInteractionEventHandler
 Inherited
keyFocusChangeHandler(event:FocusEvent):void
Processes a keyFocusChange event.
IInteractionEventHandler
 Inherited
keyUpHandler(event:KeyboardEvent):void
Processes a keyUp event.
IInteractionEventHandler
 Inherited
menuSelectHandler(event:ContextMenuEvent):void
Processes a menuSelect event.
IInteractionEventHandler
 Inherited
mouseDoubleClickHandler(event:MouseEvent):void
Processes a mouseDoubleClick event.
IInteractionEventHandler
 Inherited
mouseDownHandler(event:MouseEvent):void
Processes a mouseDown event.
IInteractionEventHandler
 Inherited
mouseMoveHandler(event:MouseEvent):void
Processes a mouseMove event.
IInteractionEventHandler
 Inherited
mouseOutHandler(event:MouseEvent):void
Processes a mouseOut event.
IInteractionEventHandler
 Inherited
mouseOverHandler(event:MouseEvent):void
Processes a mouseOver event.
IInteractionEventHandler
 Inherited
mouseUpHandler(event:MouseEvent):void
Processes a mouseUp event.
IInteractionEventHandler
 Inherited
mouseWheelHandler(event:MouseEvent):void
Processes a mouseWheel event.
IInteractionEventHandler
  
notifyInsertOrDelete(absolutePosition:int, length:int):void
Updates the selection manager when text is inserted or deleted.
ISelectionManager
  
Redisplays the selection shapes.
ISelectionManager
  
selectAll():void
Selects the entire flow.
ISelectionManager
  
selectCellRange(anchorCoords:CellCoordinates, activeCoords:CellCoordinates):void
ISelectionManager
  
Selects the first position in the entire flow.
ISelectionManager
  
Selects the last position in the entire flow.
ISelectionManager
  
selectRange(anchorPosition:int, activePosition:int):void
Selects a range of text.
ISelectionManager
  
ISelectionManager
  
setFocus():void
Gives the focus to the first container in the selection.
ISelectionManager
  
Sets the SelectionState object of the current selection.
ISelectionManager
 Inherited
Processes an softKeyboardActivating event
IInteractionEventHandler
 Inherited
textInputHandler(event:TextEvent):void
Processes a TextEvent.
IInteractionEventHandler
Property Detail
absoluteEndproperty
absoluteEnd:int  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The text position of the end of the selection, as an offset from the start of the text flow.

The absolute end is the same as either the active or the anchor point of the selection, whichever comes last in the text flow.


Implementation
    public function get absoluteEnd():int
absoluteStartproperty 
absoluteStart:int  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The text position of the start of the selection, as an offset from the start of the text flow.

The absolute start is the same as either the active or the anchor point of the selection, whichever comes first in the text flow.


Implementation
    public function get absoluteStart():int
activeCellPositionproperty 
activeCellPosition:CellCoordinates

Active end of the current cell selection, as coordinates within the table.


Implementation
    public function get activeCellPosition():CellCoordinates
    public function set activeCellPosition(value:CellCoordinates):void
activePositionproperty 
activePosition:int  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The active point of the selection.

The active point is the volatile end of the selection. The active point is changed when the selection is modified. The active point can be at either the beginning or the end of the selection.


Implementation
    public function get activePosition():int
anchorCellPositionproperty 
anchorCellPosition:CellCoordinates

Anchor point of the current cell selection, as coordinates within the table.


Implementation
    public function get anchorCellPosition():CellCoordinates
    public function set anchorCellPosition(value:CellCoordinates):void
anchorPositionproperty 
anchorPosition:int  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The anchor point of the selection.

An anchor point is the stable end of the selection. When the selection is extended, the anchor point does not change. The anchor point can be at either the beginning or the end of the selection.


Implementation
    public function get anchorPosition():int
currentCellSelectionFormatproperty 
currentCellSelectionFormat:SelectionFormat  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The current Cell SelectionFormat object.

The current cell SelectionFormat object is chosen from the SelectionFormat objects assigned to the unfocusedCellSelectionFormat, inactiveCellSelectionFormat and focusedCellSelectionFormat properties based on the current state of the windowActive and focused properties.


Implementation
    public function get currentCellSelectionFormat():SelectionFormat
currentSelectionFormatproperty 
currentSelectionFormat:SelectionFormat  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The current SelectionFormat object.

The current SelectionFormat object is chosen from the SelectionFormat objects assigned to the unfocusedSelectionFormat, inactiveSelectionFormat and focusedSelectionFormat properties based on the current state of the windowActive and focused properties.


Implementation
    public function get currentSelectionFormat():SelectionFormat
currentTableproperty 
currentTable:TableElement


Implementation
    public function get currentTable():TableElement
    public function set currentTable(value:TableElement):void
editingModeproperty 
editingMode:String  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The editing mode.

The editing mode indicates whether the text flow supports selection, editing, or only reading. A text flow is made selectable by assigning a selection manager and editable by assigning an edit manager. Constants representing the editing modes are defined in the EditingMode class.


Implementation
    public function get editingMode():String

See also

flashx.textLayout.EditingMode
focusedproperty 
focused:Boolean  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates whether a container in the text flow has the focus.

The focused property is true if any of the containers in the text flow has key focus.


Implementation
    public function get focused():Boolean
focusedCellSelectionFormatproperty 
focusedCellSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw cell selections in a focused container.


Implementation
    public function get focusedCellSelectionFormat():SelectionFormat
    public function set focusedCellSelectionFormat(value:SelectionFormat):void
focusedSelectionFormatproperty 
focusedSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw the selection in a focused container.


Implementation
    public function get focusedSelectionFormat():SelectionFormat
    public function set focusedSelectionFormat(value:SelectionFormat):void
inactiveCellSelectionFormatproperty 
inactiveCellSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw cell selections when they are not in the active window.


Implementation
    public function get inactiveCellSelectionFormat():SelectionFormat
    public function set inactiveCellSelectionFormat(value:SelectionFormat):void
inactiveSelectionFormatproperty 
inactiveSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw the selection when it is not in the active window.


Implementation
    public function get inactiveSelectionFormat():SelectionFormat
    public function set inactiveSelectionFormat(value:SelectionFormat):void
selectionTypeproperty 
selectionType:String  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates the type of selection.

The selectionType describes the kind of selection. It can either be SelectionType.TEXT or SelectionType.CELLS


Implementation
    public function get selectionType():String

See also

subManagerproperty 
subManager:ISelectionManager

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The ISelectionManager object used to for cell selections nested within the TextFlow managed by this ISelectionManager.


Implementation
    public function get subManager():ISelectionManager
    public function set subManager(value:ISelectionManager):void
superManagerproperty 
superManager:ISelectionManager

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The ISelectionManager object used to manage the parent TextFlow of this ISelectionManager (i.e. for cell ISelectionManagers).


Implementation
    public function get superManager():ISelectionManager
    public function set superManager(value:ISelectionManager):void
textFlowproperty 
textFlow:TextFlow

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The TextFlow object managed by this selection manager.

A selection manager manages a single text flow. A selection manager can also be assigned to a text flow by setting the interactionManager property of the TextFlow object.


Implementation
    public function get textFlow():TextFlow
    public function set textFlow(value:TextFlow):void

See also

unfocusedCellSelectionFormatproperty 
unfocusedCellSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw cell selections when they are not in a focused container, but are in the active window.


Implementation
    public function get unfocusedCellSelectionFormat():SelectionFormat
    public function set unfocusedCellSelectionFormat(value:SelectionFormat):void
unfocusedSelectionFormatproperty 
unfocusedSelectionFormat:SelectionFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

The SelectionFormat object used to draw the selection when it is not in a focused container, but is in the active window.


Implementation
    public function get unfocusedSelectionFormat():SelectionFormat
    public function set unfocusedSelectionFormat(value:SelectionFormat):void
windowActiveproperty 
windowActive:Boolean  [read-only]

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates whether the window associated with the text flow is active.

The windowActive property is true if the window displaying with the text flow is the active window.


Implementation
    public function get windowActive():Boolean
Method Detail
clearSelection()method
public function clearSelection():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Clears the selection shapes.

deselect()method 
public function deselect():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Removes any selection from the text flow

flushPendingOperations()method 
public function flushPendingOperations():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Executes any pending FlowOperations.

The execution of some editing operations, such as text insertion, is delayed until the next enterFrame event. Calling flushPendingOperations() causes any deferred operations to be executed immediately.

getCellRange()method 
public function getCellRange():CellRange

Returns
CellRange
getCommonCharacterFormat()method 
public function getCommonCharacterFormat(range:TextRange = null):TextLayoutFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Gets the character format attributes that are common to all characters in the specified text range or current selection.

Format attributes that do not have the same value for all characters in the specified element range or selection are set to null in the returned TextLayoutFormat instance.

Parameters

range:TextRange (default = null) — The optional range of text for which common attributes are requested. If null, the current selection is used.

Returns
TextLayoutFormat — The common character style settings
getCommonContainerFormat()method 
public function getCommonContainerFormat(range:TextRange = null):TextLayoutFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Gets the container format attributes that are common to all containers in the specified text range or current selection.

Format attributes that do not have the same value for all containers in the specified element range or selection are set to null in the returned TextLayoutFormat instance.

Parameters

range:TextRange (default = null) — The optional range of text for which common attributes are requested. If null, the current selection is used.

Returns
TextLayoutFormat — The common container style settings
getCommonParagraphFormat()method 
public function getCommonParagraphFormat(range:TextRange = null):TextLayoutFormat

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Gets the paragraph format attributes that are common to all paragraphs in the specified text range or current selection.

Format attributes that do not have the same value for all paragraphs in the specified element range or selection are set to null in the returned TextLayoutFormat instance.

Parameters

range:TextRange (default = null) — The optional range of text for which common attributes are requested. If null, the current selection is used.

Returns
TextLayoutFormat — The common paragraph style settings
getSelectionState()method 
public function getSelectionState():SelectionState

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Gets the SelectionState object of the current selection.

Returns
SelectionState

See also

hasAnySelection()method 
public function hasAnySelection():Boolean

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates whether there is a text or cell selection.

Returns true if there is either a range selection or a point selection. By default, when a selection manager is first set up, there is no selection (the start and end are -1).

Returns
Boolean
hasCellRangeSelection()method 
public function hasCellRangeSelection():Boolean

Returns
Boolean
hasSelection()method 
public function hasSelection():Boolean

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates whether there is a text selection.

Returns true if there is either a range selection or a point selection. By default, when a selection manager is first set up, there is no selection (the start and end are -1).

Returns
Boolean
isRangeSelection()method 
public function isRangeSelection():Boolean

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Indicates whether the selection covers a range of text.

Returns true if there is a selection that extends past a single position.

Returns
Boolean
notifyInsertOrDelete()method 
public function notifyInsertOrDelete(absolutePosition:int, length:int):void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Updates the selection manager when text is inserted or deleted.

Operations must call notifyInsertOrDelete when changing the text in the text flow. The selection manager adjusts index-based position indicators accordingly. If you create a new Operation class that changes text in a text flow directly (not using another operation) your operation must call this function to keep the selection up to date.

Parameters

absolutePosition:int — The point in the text where the change was made.
 
length:int — A positive or negative number indicating how many characters were inserted or deleted.

refreshSelection()method 
public function refreshSelection():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Redisplays the selection shapes.

Note: You do not need to call this method directly. It is called automatically.

selectAll()method 
public function selectAll():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Selects the entire flow.

selectCellRange()method 
public function selectCellRange(anchorCoords:CellCoordinates, activeCoords:CellCoordinates):void

Parameters

anchorCoords:CellCoordinates
 
activeCoords:CellCoordinates

selectFirstPosition()method 
public function selectFirstPosition():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Selects the first position in the entire flow.

selectLastPosition()method 
public function selectLastPosition():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Selects the last position in the entire flow.

selectRange()method 
public function selectRange(anchorPosition:int, activePosition:int):void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Selects a range of text.

If a negative number is passed as either of the parameters, then any existing selection is removed.

Parameters

anchorPosition:int — The anchor point for the new selection, as an absolute position in the TextFlow
 
activePosition:int — The active end of the new selection, as an absolute position in the TextFlow

setCellRange()method 
public function setCellRange(range:CellRange):void

Parameters

range:CellRange

setFocus()method 
public function setFocus():void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Gives the focus to the first container in the selection.

setSelectionState()method 
public function setSelectionState(state:SelectionState):void

Language Version : ActionScript 3.0
Runtime Versions : Flash Player 10, AIR 1.5

Sets the SelectionState object of the current selection.

Parameters

state:SelectionState

See also