ISelectionManager  - AS3

選取範圍結尾的文字位置 (從文字流排開頭算起的偏移量)。

絕對結尾即為選取範圍的作用點或錨點，視哪一個較晚出現在文字流排而定。

選取範圍開頭的文字位置 (從文字流排開頭算起的偏移量)。

絕對起點即為選取範圍的作用點或錨點，視哪一個先出現在文字流排而定。

選取範圍的作用點。

作用點是選取範圍的動態結尾。修改選取範圍時，作用點也會變更。作用點可以是選取範圍的起點或結尾。

選取範圍的錨點。

錨點是選取範圍的固定結尾。延伸選取範圍時，錨點並不會變更。錨點可以是選取範圍的起點或結尾。

目前 SelectionFormat 物件。

目前 SelectionFormat 物件是根據 windowActive 及 focused 屬性的目前狀態，從指定給 unfocusedSelectionFormat、inactiveSelectionFormat 及 focusedSelectionFormat 屬性的 SelectionFormat 物件中選擇。

編輯模式。

編輯模式指出文字流排支援選取、編輯還是只能讀取。指定選取管理員即可選取文字流排，而指定編輯管理員即可編輯文字流排。代表編輯模式的常數定義於 EditingMode 類別中。

相關 API 元素

指出文字流排中的容器是否具有焦點。

如果文字流排中的任一容器具有主要焦點，則 focused 屬性是 true。

用來在具有焦點的容器中繪製選取範圍的 SelectionFormat 物件。

當選取範圍不在作用中視窗時，用來繪製選取範圍的 SelectionFormat 物件。

此選取管理員所管理的 TextFlow 物件。

選取管理員可管理單一文字流排。藉由設定 TextFlow 物件的 interactionManager 屬性，您也可以將選取管理員指定給文字流排。

相關 API 元素

當選取範圍不在具有焦點的容器但在作用中視窗時，用來繪製選取範圍的SelectionFormat 物件。

指出與文字流排相關的視窗是否為作用中視窗。

如果顯示文字流排的視窗是作用中視窗，則 windowActive 屬性是 true。

執行任何擱置 FlowOperation。

部分編輯作業的執行 (如文字插入) 會延遲到下一個 enterFrame 事件時才進行。呼叫 flushPendingOperations() 會立即執行任何延遲的作業。

取得指定文字範圍或目前選取範圍中所有字元都適用的字元格式特質。

在傳回的 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();

指出選取範圍是否涵蓋某範圍的文字。

如果選取範圍延伸超過單一位置，則傳回 true。

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

插入或刪除文字時，更新選取管理員。

變更文字流排中的文字時，作業必須呼叫 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 );
}

重新顯示選取範圍形狀。

注意：您不需要直接呼叫此方法。一般會自動進行呼叫。

選取整個流排。

選取一個文字範圍。

如果將負數傳遞為任一參數，則會移除任何現有選取範圍。

參數

 var textFlow:TextFlow = TextConverter.importToFlow( "Let me not to the marriage of true minds", TextConverter.PLAIN_TEXT_FORMAT );
 textFlow.interactionManager = new SelectionManager();
 
 textFlow.interactionManager.selectRange( 18, 26 ); // Selects the word 'marriage'

將焦點放在選取範圍的第一個容器。

 textFlow.interactionManager.setFocus();

設定目前選取範圍的 SelectionState 物件。

參數

相關 API 元素