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 事件。

已針對剪下、複製、貼上及全選指令發送 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
        }
        
    }        
}