ISelectionManager - Adobe ActionScript® 3 (AS3 ) API 참조 설명서

패키지	flashx.textLayout.edit
인터페이스	public interface ISelectionManager extends IInteractionEventHandler
구현자	SelectionManager

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

ISelectionManager 인터페이스는 텍스트 선택 영역을 처리하는 인터페이스를 정의합니다.

SelectionManager는 선택된 텍스트 범위를 추적하고 TextFlow에 대한 이벤트를 처리합니다.

지점을 선택할 수도 있고 범위를 선택할 수도 있습니다. 지점 선택은 삽입 지점이며 커서로 그려서 나타냅니다. 범위 선택에는 기준점과 활성 지점 사이의 텍스트가 포함됩니다.

공용 속성

	속성		정의 주체
		absoluteEnd : int [읽기 전용] 텍스트 흐름의 시작을 기준으로 하는 오프셋으로서, 선택 영역의 끝에 있는 텍스트 위치입니다.	ISelectionManager
		absoluteStart : int [읽기 전용] 텍스트 흐름의 시작을 기준으로 하는 오프셋으로서, 선택 영역의 시작 부분에 있는 텍스트 위치입니다.	ISelectionManager
		activePosition : int [읽기 전용] 선택 영역의 활성 지점입니다.	ISelectionManager
		anchorPosition : int [읽기 전용] 선택 영역의 기준점입니다.	ISelectionManager
		currentSelectionFormat : SelectionFormat [읽기 전용] 현재 SelectionFormat 객체입니다.	ISelectionManager
		editingMode : String [읽기 전용] 편집 모드입니다.	ISelectionManager
		focused : Boolean [읽기 전용] 텍스트 흐름의 컨테이너에 포커스가 있는지 여부를 나타냅니다.	ISelectionManager
		focusedSelectionFormat : SelectionFormat 포커스된 컨테이너의 선택 영역을 그리는 데 사용된 SelectionFormat 객체입니다.	ISelectionManager
		inactiveSelectionFormat : SelectionFormat SelectionFormat 객체는 선택 영역이 활성 창에 없는 경우 선택 영역을 그리는 데 사용됩니다.	ISelectionManager
		textFlow : flashx.textLayout.elements:TextFlow 이 선택 영역 관리자에서 관리할 TextFlow 객체입니다.	ISelectionManager
		unfocusedSelectionFormat : SelectionFormat SelectionFormat 객체는 선택 영역이 포커스된 컨테이너에 없지만 활성 창에 있는 경우 선택 영역을 그리는 데 사용됩니다.	ISelectionManager
		windowActive : Boolean [읽기 전용] 텍스트 흐름과 연결된 창이 활성 상태인지 여부를 나타냅니다.	ISelectionManager

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		activateHandler(event:Event):void 활성화 이벤트를 처리합니다.	IInteractionEventHandler
		deactivateHandler(event:Event):void 비활성화 이벤트를 처리합니다.	IInteractionEventHandler
		editHandler(event:Event):void 편집 이벤트를 처리합니다.	IInteractionEventHandler
		flushPendingOperations():void 보류 중인 FlowOperation을 실행합니다.	ISelectionManager
		focusChangeHandler(event:FocusEvent):void focusChange 이벤트를 처리합니다.	IInteractionEventHandler
		focusInHandler(event:FocusEvent):void focusIn 이벤트를 처리합니다.	IInteractionEventHandler
		focusOutHandler(event:FocusEvent):void focusOut 이벤트를 처리합니다.	IInteractionEventHandler
		getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat 지정한 텍스트 범위 또는 현재 선택 영역의 모든 문자에 대해 공통된 문자 서식 특성을 가져옵니다.	ISelectionManager
		getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat 지정한 텍스트 범위 또는 현재 선택 영역의 모든 컨테이너에 대해 공통된 컨테이너 서식 특성을 가져옵니다.	ISelectionManager
		getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat 지정한 텍스트 범위 또는 현재 선택 영역의 모든 단락에 대해 공통된 단락 서식 특성을 가져옵니다.	ISelectionManager
		getSelectionState():SelectionState 현재 선택 영역의 SelectionState 객체를 가져옵니다.	ISelectionManager
		hasSelection():Boolean 선택 영역이 있는지 여부를 나타냅니다.	ISelectionManager
		imeStartCompositionHandler(event:IMEEvent):void imeStartComposition 이벤트를 처리합니다.	IInteractionEventHandler
		isRangeSelection():Boolean 선택 영역이 텍스트 범위를 포함하는지 여부를 나타냅니다.	ISelectionManager
		keyDownHandler(event:KeyboardEvent):void keyDown 이벤트를 처리합니다.	IInteractionEventHandler
		keyFocusChangeHandler(event:FocusEvent):void keyFocusChange 이벤트를 처리합니다.	IInteractionEventHandler
		keyUpHandler(event:KeyboardEvent):void keyUp 이벤트를 처리합니다.	IInteractionEventHandler
		menuSelectHandler(event:ContextMenuEvent):void menuSelect 이벤트를 처리합니다.	IInteractionEventHandler
		mouseDoubleClickHandler(event:MouseEvent):void mouseDoubleClick 이벤트를 처리합니다.	IInteractionEventHandler
		mouseDownHandler(event:MouseEvent):void mouseDown 이벤트를 처리합니다.	IInteractionEventHandler
		mouseMoveHandler(event:MouseEvent):void mouseMove 이벤트를 처리합니다.	IInteractionEventHandler
		mouseOutHandler(event:MouseEvent):void mouseOut 이벤트를 처리합니다.	IInteractionEventHandler
		mouseOverHandler(event:MouseEvent):void mouseOver 이벤트를 처리합니다.	IInteractionEventHandler
		mouseUpHandler(event:MouseEvent):void mouseUp 이벤트를 처리합니다.	IInteractionEventHandler
		mouseWheelHandler(event:MouseEvent):void mouseWheel 이벤트를 처리합니다.	IInteractionEventHandler
		notifyInsertOrDelete(absolutePosition:int, length:int):void 텍스트가 삽입되거나 삭제되면 선택 영역 관리자를 업데이트합니다.	ISelectionManager
		refreshSelection():void 선택 영역 모양을 다시 표시합니다.	ISelectionManager
		selectAll():void 전체 흐름을 선택합니다..	ISelectionManager
		selectRange(anchorPosition:int, activePosition:int):void 텍스트 범위를 선택합니다.	ISelectionManager
		setFocus():void 선택 영역의 첫 번째 컨테이너에 포커스를 둡니다.	ISelectionManager
		setSelectionState(state:SelectionState):void 현재 선택 영역의 SelectionState 객체를 설정합니다.	ISelectionManager
		softKeyboardActivatingHandler(event:Event):void softKeyboardActivating 이벤트를 처리합니다.	IInteractionEventHandler
		textInputHandler(event:flash.events:TextEvent):void TextEvent를 처리합니다.	IInteractionEventHandler

속성 세부 정보

absoluteEnd

속성

absoluteEnd:int [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트 흐름의 시작을 기준으로 하는 오프셋으로서, 선택 영역의 끝에 있는 텍스트 위치입니다.

절대 끝점은 선택 영역의 활성 지점 또는 기준점과 동일하며 항상 텍스트 흐름의 끝에 있습니다.

구현
public function get absoluteEnd():int

absoluteStart

속성

absoluteStart:int [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트 흐름의 시작을 기준으로 하는 오프셋으로서, 선택 영역의 시작 부분에 있는 텍스트 위치입니다.

절대 시작점은 선택 영역의 활성 지점 또는 기준점과 동일하며 항상 텍스트 흐름의 시작 부분에 있습니다.

구현
public function get absoluteStart():int

activePosition

속성

activePosition:int [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역의 활성 지점입니다.

활성 지점은 선택 영역의 일시적인 끝점입니다. 선택 영역이 수정되면 활성 지점도 변경됩니다. 활성 지점은 선택 영역의 시작 또는 끝 부분에 올 수 있습니다.

구현
public function get activePosition():int

anchorPosition

속성

anchorPosition:int [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역의 기준점입니다.

기준점은 선택 영역의 고정 끝점입니다. 선택 영역이 확장되어도 기준점은 변경되지 않습니다. 기준점은 선택 영역의 시작 또는 끝 부분에 올 수 있습니다.

구현
public function get anchorPosition():int

currentSelectionFormat

속성

currentSelectionFormat:SelectionFormat [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

현재 SelectionFormat 객체입니다.

현재 SelectionFormat 객체는 windowActive 및 focused 속성의 현재 상태를 기준으로 unfocusedSelectionFormat, inactiveSelectionFormat 및 focusedSelectionFormat 속성에 할당된 SelectionFormat 객체에서 선택됩니다.

구현
public function get currentSelectionFormat():SelectionFormat

editingMode

속성

editingMode:String [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

편집 모드입니다.

편집 모드는 텍스트 흐름이 선택 및 편집을 지원하는지 또는 읽기 전용인지 여부를 나타냅니다. 텍스트 흐름에 선택 영역 관리자를 할당하면 선택이 가능하고 편집 관리자를 할당하면 편집이 가능합니다. 편집 모드를 나타내는 상수는 EditingMode 클래스에서 정의됩니다.

구현
public function get editingMode():String

관련 API 요소

flashx.textLayout.EditingMode

focused

속성

focused:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트 흐름의 컨테이너에 포커스가 있는지 여부를 나타냅니다.

텍스트 흐름의 컨테이너에 주요 포커스가 있는 경우 focused 속성은 true입니다.

구현
public function get focused():Boolean

focusedSelectionFormat

속성

focusedSelectionFormat:SelectionFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

포커스된 컨테이너의 선택 영역을 그리는 데 사용된 SelectionFormat 객체입니다.

구현
public function get focusedSelectionFormat():SelectionFormat
public function set focusedSelectionFormat(value:SelectionFormat):void

inactiveSelectionFormat

속성

inactiveSelectionFormat:SelectionFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

SelectionFormat 객체는 선택 영역이 활성 창에 없는 경우 선택 영역을 그리는 데 사용됩니다.

구현
public function get inactiveSelectionFormat():SelectionFormat
public function set inactiveSelectionFormat(value:SelectionFormat):void

textFlow

속성

textFlow:flashx.textLayout.elements:TextFlow

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

이 선택 영역 관리자에서 관리할 TextFlow 객체입니다.

선택 영역 관리자는 단일 텍스트 흐름을 관리하고 TextFlow 객체의 interactionManager 속성을 설정하여 텍스트 흐름에 할당할 수도 있습니다.

구현
public function get textFlow():flashx.textLayout.elements:TextFlow
public function set textFlow(value:flashx.textLayout.elements:TextFlow):void

unfocusedSelectionFormat

속성

unfocusedSelectionFormat:SelectionFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

SelectionFormat 객체는 선택 영역이 포커스된 컨테이너에 없지만 활성 창에 있는 경우 선택 영역을 그리는 데 사용됩니다.

구현
public function get unfocusedSelectionFormat():SelectionFormat
public function set unfocusedSelectionFormat(value:SelectionFormat):void

windowActive

속성

windowActive:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트 흐름과 연결된 창이 활성 상태인지 여부를 나타냅니다.

텍스트 흐름을 표시하는 창이 활성 창인 경우 windowActive 속성은 true입니다.

구현
public function get windowActive():Boolean

메서드 세부 정보

flushPendingOperations

()

메서드

public function flushPendingOperations():void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

보류 중인 FlowOperation을 실행합니다.

텍스트 삽입과 같은 일부 편집 작업을 실행하면 다음 enterFrame 이벤트까지 작업이 지연됩니다. flushPendingOperations()를 호출하면 연기된 작업이 즉각적으로 실행됩니다.

getCommonCharacterFormat

()

메서드

 public function getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

지정한 텍스트 범위 또는 현재 선택 영역의 모든 문자에 대해 공통된 문자 서식 특성을 가져옵니다.

지정한 요소 범위 또는 선택 영역의 모든 문자에 대한 값이 동일하지 않은 서식 특성은 반환된 TextLayoutFormat 인스턴스에서 null로 설정됩니다.

매개 변수

range:flashx.textLayout.elements:TextRange (default = null) — 일반 특성이 요청되는 텍스트의 선택적 범위입니다. null인 경우 현재 선택 영역이 사용됩니다.

반환값

flashx.textLayout.formats:TextLayoutFormat — 일반 문자 스타일 설정입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 선택 영역의 모든 요소에 공통적인 문자 스타일 설정을 포함하는 ITextLayoutFormat 객체를 가져오는 방법을 보여 줍니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

getCommonContainerFormat

()

메서드

 public function getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

지정한 텍스트 범위 또는 현재 선택 영역의 모든 컨테이너에 대해 공통된 컨테이너 서식 특성을 가져옵니다.

지정한 요소 범위 또는 선택 영역의 모든 컨테이너에 대한 값이 동일하지 않은 서식 특성은 반환된 TextLayoutFormat 인스턴스에서 null로 설정됩니다.

매개 변수

range:flashx.textLayout.elements:TextRange (default = null) — 일반 특성이 요청되는 텍스트의 선택적 범위입니다. null인 경우 현재 선택 영역이 사용됩니다.

반환값

flashx.textLayout.formats:TextLayoutFormat — 일반 컨테이너 스타일 설정입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 선택 영역의 모든 요소에 공통적인 컨테이너 스타일 설정을 포함하는 ITextLayoutFormat 객체를 가져오는 방법을 보여 줍니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

getCommonParagraphFormat

()

메서드

 public function getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

지정한 텍스트 범위 또는 현재 선택 영역의 모든 단락에 대해 공통된 단락 서식 특성을 가져옵니다.

지정한 요소 범위 또는 선택 영역의 모든 단락에 대한 값이 동일하지 않은 서식 특성은 반환된 TextLayoutFormat 인스턴스에서 null로 설정됩니다.

매개 변수

range:flashx.textLayout.elements:TextRange (default = null) — 일반 특성이 요청되는 텍스트의 선택적 범위입니다. null인 경우 현재 선택 영역이 사용됩니다.

반환값

flashx.textLayout.formats:TextLayoutFormat — 일반 단락 스타일 설정입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 선택 영역의 모든 요소에 공통적인 단락 스타일 설정을 포함하는 ITextLayoutFormat 객체를 가져오는 방법을 보여 줍니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

getSelectionState

()

메서드

public function getSelectionState():SelectionState

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

현재 선택 영역의 SelectionState 객체를 가져옵니다.

반환값

SelectionState

관련 API 요소

flashx.textLayout.edit.SelectionState

예제 ( 예제 사용 방법 )

다음 예제에서는 텍스트 흐름의 현재 선택 영역에 대한 SelectionState 객체를 가져옵니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

hasSelection

()

메서드

public function hasSelection():Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역이 있는지 여부를 나타냅니다.

범위나 지점이 선택된 경우 true 값이 반환됩니다. 기본적으로 선택 영역 관리자가 처음 설정된 경우에는 선택 영역이 없으므로 시작과 끝이 -1입니다.

반환값

Boolean

예제 ( 예제 사용 방법 )

다음 예제에서는 텍스트 흐름에 선택 영역이 있는지 여부를 확인하는 방법을 보여 줍니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

isRangeSelection

()

메서드

public function isRangeSelection():Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역이 텍스트 범위를 포함하는지 여부를 나타냅니다.

선택 영역이 단일 위치 너머로 확장되는 경우 true 값이 반환됩니다.

반환값

Boolean

예제 ( 예제 사용 방법 )

다음 예제에서는 텍스트 흐름의 현재 선택 영역이 텍스트 범위로 확장되는지 여부를 확인하는 방법을 보여 줍니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

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

notifyInsertOrDelete

()

메서드

public function notifyInsertOrDelete(absolutePosition:int, length:int):void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트가 삽입되거나 삭제되면 선택 영역 관리자를 업데이트합니다.

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

매개 변수

	`absolutePosition:int` — 텍스트가 변경된 지점입니다.

	`length:int` — 삽입되거나 삭제된 문자 수를 나타내는 양수 또는 음수입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 사용자 정의 Operation 클래스의 함수가 notifyInsertOrDelete() 메서드를 호출하는 방법을 보여 줍니다.

이 함수는 SpanElement의 텍스트 범위를 가상 작업의 일부로 대체합니다.

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

refreshSelection

()

메서드

public function refreshSelection():void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역 모양을 다시 표시합니다.

참고: 이 메서드는 자동으로 호출되므로 직접 호출할 필요는 없습니다.

selectAll

()

메서드

public function selectAll():void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

전체 흐름을 선택합니다.

selectRange

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

텍스트 범위를 선택합니다.

음수가 매개 변수 중 하나로 전달되는 경우 기존의 선택 영역이 제거됩니다.

매개 변수

	`anchorPosition:int` — TextFlow의 절대 위치로서, 새 선택 영역의 기준점입니다.

	`activePosition:int` — TextFlow의 절대 위치로서, 새 선택 영역의 활성 끝점입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 텍스트 흐름을 만들고 선택 영역을 지정합니다.

 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'

setFocus

()

메서드

public function setFocus():void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

선택 영역의 첫 번째 컨테이너에 포커스를 둡니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 텍스트 흐름의 현재 선택 영역에서 첫 번째 컨테이너에 포커스를 설정합니다. 예제에서 textFlow 변수는 TextFlow 객체입니다.

 textFlow.interactionManager.setFocus();

setSelectionState

()

메서드

public function setSelectionState(state:SelectionState):void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

현재 선택 영역의 SelectionState 객체를 설정합니다.

매개 변수

state:SelectionState

관련 API 요소

flashx.textLayout.edit.SelectionState

법적 고지 사항 | 온라인 개인 정보 보호 정책

ISelectionManager - AS3

클래스 x

absoluteEnd

absoluteStart

activePosition

anchorPosition

currentSelectionFormat

editingMode

focused

focusedSelectionFormat

inactiveSelectionFormat

textFlow

unfocusedSelectionFormat

windowActive

flushPendingOperations

getCommonCharacterFormat

getCommonContainerFormat

getCommonParagraphFormat

getSelectionState

hasSelection

isRangeSelection

notifyInsertOrDelete

refreshSelection

selectAll

selectRange

setFocus

setSelectionState