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 속성에 할당하여 텍스트 선택이 가능하도록 설정합니다.

활성화 이벤트를 처리합니다.

매개 변수

비활성화 이벤트를 처리합니다.

매개 변수

SelectionManager 작업 수행 - 이를 통해 흐름을 수정할 수는 없지만 클라이언트가 이 작업을 취소할 수 있습니다.

매개 변수

편집 이벤트를 처리합니다.

편집 이벤트는 cut, copy, paste 및 selectAll 명령에 대해 전달됩니다.

매개 변수

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를 호출해야 합니다. 그에 따라 선택 영역 관리자가 인덱스 기반 위치 표시기를 조정합니다. 다른 작업을 사용하지 않고 텍스트 흐름의 텍스트를 직접 변경하는 새 작업 그룹을 만드는 경우 작업은 이 함수를 호출하여 선택 영역을 최신으로 유지해야 합니다.

매개 변수

 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
        }
        
    }        
}