SelectionManager  - AS3

选择部分末尾的文本位置，是自文本流起始位置的偏移。

绝对终点与选择部分的活动点或锚点相同，具体取决于哪一个在文本流中更靠后。

选择部分开头的文本位置，是自文本流起始位置的偏移。

绝对起点与选择部分的活动点或锚点相同，具体取决于哪一个在文本流中更靠前。

选择部分的活动点。

活动点是选择部分的不定终点。活动点随选择的修改而改变。活动点可以位于当前选择的起始或结束位置。

选择部分的锚点。

锚点是选择部分的固定终点。当扩展选择部分时，锚点不会随之改变。锚点可以位于当前选择的起始或结束位置。

当前 SelectionFormat 对象。

当前 SelectionFormat 对象根据 windowActive 和 focused 属性的当前状态，从指定给 unfocusedSelectionFormat、inactiveSelectionFormat 和 focusedSelectionFormat 属性的 SelectionFormat 对象中进行选择。

相关 API 元素

编辑模式。

编辑模式指示文本流是支持选择、编辑还是只读。通过指定选择管理器可允许对文本流进行选择，通过指定编辑管理器可允许对文本流进行编辑。表示编辑模式的常量在 EditingMode 类中进行定义。

相关 API 元素

指示文本流中的容器是否具有焦点。

如果文本流中的任意容器具有主焦点，则 focused 属性为 true。

用于在焦点容器中绘制选择的 SelectionFormat 对象。

相关 API 元素

当选择部分不在活动窗口中时，用于绘制选择的 SelectionFormat 对象。

相关 API 元素

将应用于所插入文本的格式。TBD：需要扩展 pointFormat 以记住点选区上使用 leafFormat 值对 IEditManager.undefineFormat 的调用中的用户样式和“未定义”格式。

由该选择管理器管理的 TextFlow 对象。

一个选择管理器只管理一个文本流。也可通过设置 TextFlow 对象的 interactionManager 属性，将选择管理器指定给相应文本流。

相关 API 元素

当选择部分不在焦点容器内但是位于活动窗口中时，用于绘制选择的 SelectionFormat 对象。

相关 API 元素

指示与文本流关联的窗口是否是活动窗口。

如果显示文本流的窗口是活动窗口，则 windowActive 属性为 true。

创建 SelectionManager 对象。

将一个 SelectionManager 对象指定给文本流的 interactionManager 属性可允许选择文本。

处理 activate 事件。

参数

处理 deactivate 事件。

参数

执行 SelectionManager 操作 — 这些操作可能从不修改流，但客户端仍能够取消它们。

参数

处理 edit 事件。

对于剪切、复制、粘贴和全选命令会调度编辑事件。

参数

处理 focusChange 事件。

参数

处理 focusIn 事件。

参数

处理 focusOut 事件。

参数

获取对于指定的文本范围或当前所选项目中的所有字符都通用的字符格式属性。

对于指定的元素范围或选区中的所有字符具有不同值的格式属性在返回的 TextLayoutFormat 实例中设置为 null。

参数

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();

获取对于指定的文本范围或当前所选项目中的所有容器都通用的容器格式属性。

对于指定的元素范围或选区中的所有容器具有不同值的格式属性在返回的 TextLayoutFormat 实例中设置为 null。

参数

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();

获取对于指定的文本范围或当前选区中的所有段落都通用的段落格式属性。

对于指定的元素范围或选区中的所有段落具有不同值的格式属性在返回的 TextLayoutFormat 实例中设置为 null。

参数

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();

获取当前所选内容的 SelectionState 对象。

相关 API 元素

 var selection:SelectionState = textFlow.interactionManager.getSelectionState();

指示是否进行了选择。

如果进行了范围选择或点选择，则返回 true。默认情况下，首次设置选择管理器时，不会进行选择（开始和结束都是 -1）。

 var selection:SelectionState = textFlow.interactionManager.hasSelection();

处理 imeStartComposition 事件。

参数

指示选择时是否涵盖某一文本范围。

如果选择时包括多个位置，则返回 true。

 var selection:SelectionState = textFlow.interactionManager.isRangeSelection();

处理 keyDown 事件。

参数

处理 keyFocusChange 事件。

参数

处理 keyUp 事件。

参数

处理 menuSelect 事件。

参数

处理 mouseDoubleClick 事件。

参数

处理 mouseDown 事件。

参数

处理 mouseMove 事件。

参数

处理 mouseOut 事件。

参数

处理 mouseOver 事件。

参数

处理 mouseUp 事件。

参数

处理 mouseWheel 事件。

参数

插入或删除文本时更新选择管理器。

更改文本流中的文本时，操作必须调用 notifyInsertOrDelete。选择管理器相应地调整基于索引的位置指示符。如果创建的新 Operation 类直接在文本流中更改文本（不使用其它操作），则该操作必须调用此函数使选择保持最新。

参数

 import flashx.textLayout.elements.SpanElement;
 

function doReplace( span:SpanElement, newText:String, relativeStart:int, relativeEnd:int ):void
{
    span.replaceText(  relativeStart, relativeEnd, newText );
    var parentFlow:TextFlow = span.getTextFlow();
    var lengthDifference:int = newText.length - (relativeEnd - relativeStart);

    parentFlow.interactionManager.notifyInsertOrDelete(    span.getAbsoluteStart() + relativeStart, lengthDifference );
}

重新显示选择形状。

注意：您无需直接调用此方法。该方法是自动调用的。

相关 API 元素

参数

相关 API 元素

将焦点设置到所选内容中的第一个容器。

 textFlow.interactionManager.setFocus();

设置鼠标光标。

参数

设置当前选定内容的 SelectionState 对象。

参数

相关 API 元素

处理 softKeyboardActivating 事件

参数

处理 TextEvent。

参数

此示例演示如何使用 SelectionManager 类。

该代码段先针对选定内容更改建立 TextFlow 和并添加侦听器，然后根据选定内容更改进行更新。

package flashx.textLayout.edit.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.ITextLayoutFormat;
    import flashx.textLayout.events.SelectionEvent;

    public class SelectionManager_example extends Sprite
    {
        private var textFlow:TextFlow;
        
        public function SelectionManager_example()
        {
            //define TextFlow, and make it read-select
            textFlow = TextConverter.importToFlow("This is sample text for the SelectionManager example.",
                TextConverter.PLAIN_TEXT_FORMAT);
            textFlow.interactionManager = new SelectionManager();
            
            //compose TextFlow to display
            textFlow.flowComposer.addController(new ContainerController(this,600,600));
            textFlow.flowComposer.updateAllControllers();
            
            //add event handlers to the TextFlow to detect when selection changes
            textFlow.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionChanged);
        }

        private function selectionChanged(selectionEvent:SelectionEvent):void
        {
            var format:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();
            // do something here - perhaps update the application's UI based on the formatting
            // attributes applied in the current selected text range
        }
        
    }        
}